ProviderSetObject (Compact 2013)

3/26/2014

This function sets information that is associated with a network interface.

Syntax

NDIS_STATUS
  ProviderSetObject(
    IN NDIS_HANDLE  ProviderIfContext,
    IN NET_IF_OBJECT_ID  ObjectId,
    IN ULONG  InputBufferLength,
    IN PVOID  pInputBuffer
    );

Parameters

• 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.

• 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.

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

• 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:

Value	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 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.

See Also

Reference

NDIS Network Interface Provider Functions
NdisIfRegisterInterface