NdisFOidRequest function (ndis.h)
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) |