Share via


NdisFOidRequest (Compact 2013)

3/26/2014

Filter drivers call this function to forward an OID request to underlying drivers or to originate such a request.

Syntax

NDIS_STATUS
  NdisFOidRequest(
    IN NDIS_HANDLE  NdisFilterHandle,
    IN PNDIS_OID_REQUEST  OidRequest
    );

Parameters

  • NdisFilterHandle
    An NDIS handle that identifies a filter module. NDIS passed the handle to the filter driver in a call to the FilterAttach function.
  • OidRequest
    A pointer to an NDIS_OID_REQUEST structure that specifies the operation requested with a given OID_XXX code. The structure can specify a query, set, or method request. For more information about OIDs, see NDIS OIDs.

Return Value

See the Status parameter of the NdisOidRequest function.

Remarks

Filter drivers can originate OID requests to underlying drivers by calling NdisFOidRequest.

Filter drivers can also filter OID requests that are originated by overlying drivers. NDIS calls the FilterOidRequest function to process each such request.

If NdisFOidRequest returns NDIS_STATUS_PENDING, NDIS calls the FilterOidRequestComplete function after the underlying drivers complete the OID request.

If NdisFOidRequest returns NDIS_STATUS_SUCCESS, it returns the results of a query request in the NDIS_OID_REQUEST structure at the OidRequest parameter.

NdisFOidRequest can return NDIS_STATUS_INVALID_PARAMETER if the filter driver passes invalid values for the Type and Size fields in the Header field of the NDIS_OID_REQUEST structure.

A driver can call NdisFOidRequest when it is in the Restarting, Running, Pausing, or Paused state.

Requirements

Header

ndis.h

See Also

Reference

NDIS OID Request Interface for Filter Drivers
FilterAttach
FilterOidRequest
FilterOidRequestComplete
NDIS_OID_REQUEST
NdisOidRequest