Share via


ProviderQueryObject (Compact 2013)

3/26/2014

This function retrieves information about a network interface.

Syntax

NDIS_STATUS
  ProviderQueryObject(
    IN NDIS_HANDLE  ProviderIfContext,
    IN NET_IF_OBJECT_ID  ObjectId,
    IN OUT PULONG  pOutputBufferLength,
    OUT PVOID  pOutputBuffer
    );

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 query request. For a list of object identifiers (OIDs) that apply to interface providers, see NDIS Network Interface OIDs.
  • pOutputBufferLength
    A pointer to an NDIS-supplied variable in which NDIS provides the length of the output buffer. ProviderQueryObject writes the length of the data that it put in the output buffer.
  • pOutputBuffer
    A pointer to an NDIS-supplied output buffer in which ProviderQueryObject writes the response to the query request.

Return Value

ProviderQueryObject returns one of the following status values:

  • 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 ProviderQueryObject function to obtain information about an interface that the provider registered. For a list of OIDs that apply to interface providers, see NDIS Network Interface OIDs.

NDIS calls ProviderQueryObject at IRQL = PASSIVE_LEVEL.

See Also

Reference

NDIS Network Interface Provider Functions
NdisIfRegisterInterface