IF_SET_OBJECT callback function (ndis.h)

  • Article

The ProviderSetObject function sets information that is associated with a network interface.

Syntax

IF_SET_OBJECT IfSetObject;

NDIS_STATUS() IfSetObject(
  [in] NDIS_HANDLE ProviderIfContext,
  [in] NET_IF_OBJECT_ID ObjectId,
  [in] ULONG InputBufferLength,
  [in] PVOID pInputBuffer
)
{...}

Parameters

[in] ProviderIfContext

A handle that identifies the interface provider's context area for the interface. The interface provider passed this handle to NDIS in a call to the NdisIfRegisterInterface function.

[in] ObjectId

An identifier for the object that is the target of the set request. For a list of object identifiers (OIDs) that apply to interface providers, see NDIS Network Interface OIDs.

[in] InputBufferLength

The length, in bytes, of the buffer that pInputBuffer points to.

[in] pInputBuffer

A pointer to an input buffer that specifies the information that the interface provider should use to set the object data.

Return value

ProviderSetObject returns one of the following status values:

Return code Description
NDIS_STATUS_SUCCESS
 The operation completed successfully.
NDIS_STATUS_RESOURCES
 The operation failed because of insufficient resources.
NDIS_STATUS_INVALID_PARAMETER
 The call failed because some of the input parameters were invalid.
NDIS_STATUS_Xxx
 The call failed for some other reason. This function can propagate error codes from the functions that it calls or generate an appropriate error code.

Remarks

NDIS calls a network interface provider's ProviderSetObject function to set information that is associated with an interface that the provider registered. For a list of OIDs that apply to interface providers, see NDIS Network Interface OIDs.

Note that there are currently no set OIDs defined.

NDIS calls ProviderSetObject at IRQL = PASSIVE_LEVEL.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 6.0 and later.
Target Platform Windows
Header ndis.h (include Ndis.h)
IRQL PASSIVE_LEVEL

See also

NdisIfRegisterInterface