NdisFOidRequest function (ndis.h)

Article
02/22/2024

Filter drivers call the NdisFOidRequest 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

[in] NdisFilterHandle

An NDIS handle that identifies a filter module. NDIS passed the handle to the filter driver in a call to the FilterAttach function.

[in] 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 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

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and later.
Target Platform	Desktop
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	Irql_OID_Function(ndis)