ProviderSetObject (Compact 2013)

  • Articolo

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