NdisFOidRequestComplete function (ndis.h)

Article
02/22/2024

Filter drivers call the NdisFOidRequestComplete function to return the final status of an OID request for which the driver's FilterOidRequest function returned NDIS_STATUS_PENDING.

Syntax

void NdisFOidRequestComplete(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest,
  [in] NDIS_STATUS       Status
);

Parameters

[in] NdisFilterHandle

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

[in] OidRequest

A pointer to a buffer formatted as an NDIS_OID_REQUEST structure. The filter driver obtained this pointer as an input parameter to its FilterOidRequest function.

[in] Status

The final status of the request operation, either NDIS_STATUS_SUCCESS or any driver-determined NDIS_STATUS_XXX value except NDIS_STATUS_PENDING.

Return value

None

Remarks

A filter driver that returns NDIS_STATUS_PENDING from its FilterOidRequest function must call the NdisFOidRequestComplete function after the driver has finished the request operation.

If an overlying driver originated the OID request, NDIS calls the request complete function of the overlying driver after the filter driver calls NdisFOidRequestComplete.

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)