Share via

FilterOidRequestComplete (Compact 7)

  • Article

3/12/2014

NDIS calls the FilterOidRequestComplete function to complete a filter driver request that queried or set information in an underlying driver.

Syntax

VOID
  FilterOidRequestComplete(
    IN NDIS_HANDLE  FilterModuleContext,
    IN PNDIS_OID_REQUEST  OidRequest,
    IN NDIS_STATUS  Status
    );

Parameters

  • FilterModuleContext
    A handle to the context area for the filter module. The filter driver created and initialized this context area in the FilterAttach function.
  • Status
    The final status of the request set by an underlying driver or by NDIS. This parameter determines what FilterOidRequestComplete does with the information at OidRequest. For a list of the possible status values, see the return values of NdisFOidRequest.

Return Value

None

Remarks

FilterOidRequestComplete is an optional function. If a filter driver does not use OID requests, it can set the entry point for this function to NULL when it calls the NdisFRegisterFilterDriver function. If a filter driver defines a FilterOidRequest function, it must provide the FilterOidRequestComplete function.

If the NdisFOidRequest function returns NDIS_STATUS_PENDING, NDIS must call the FilterOidRequestComplete function to complete the OID request.

If a filter driver forwarded a request that it received in the FilterOidRequest function, FilterOidRequestComplete should pass the completion status up the driver stack by calling the NdisFOidRequestComplete function. The filter driver must call NdisFreeCloneOidRequest, to free the NDIS_OID_REQUEST structure, before it calls NdisFOidRequestComplete.

A filter driver should keep track of requests that it originates and make sure that it does not call NdisFOidRequestComplete when NDIS calls FilterOidRequestComplete for such requests.

NDIS calls FilterOidRequestComplete at IRQL <= DISPATCH_LEVEL.

Requirements

Header

filter.h

See Also

Reference

NDIS OID Request Interface for Filter Drivers
FilterAttach
FilterOidRequest
NDIS_OID_REQUEST
NdisFreeCloneOidRequest
NdisFOidRequest
NdisFOidRequestComplete