Share via

MiniportCancelOidRequest (Compact 7)

  • Article

3/12/2014

NDIS calls a miniport driver's MiniportCancelOidRequest function to cancel an OID request.

Syntax

VOID
  MiniportCancelOidRequest(
    IN NDIS_HANDLE  MiniportAdapterContext,
    IN PVOID  RequestId
    );

Parameters

  • MiniportAdapterContext
    A handle to a context area that the miniport driver allocated in its MiniportInitializeEx function. The miniport driver uses this context area to maintain state information for a miniport adapter.
  • RequestId
    A cancellation identifier for the request. This identifier specifies the NDIS_OID_REQUEST structures that are being canceled.

Return Value

None

Remarks

A driver specifies the MiniportCancelOidRequest entry point when it calls the NdisMRegisterMiniportDriver function.

When NDIS calls MiniportCancelOidRequest, the miniport driver should attempt to call NdisMOidRequestComplete function as soon as possible.

The request parameters are defined in the NDIS_OID_REQUEST structure at OidRequest.

NDIS calls MiniportCancelOidRequest either when the originator of the request cancels the request or when the time-out, specified at the Time-Out member, expires.

If the request processing is still incomplete in a miniport driver, the driver calls the NdisMOidRequestComplete function with the status set to NDIS_STATUS_REQUEST_ABORTED.

If the request processing is still incomplete in an intermediate driver and the request was propagated to an underlying driver, the intermediate driver calls the NdisCancelOidRequest function with the OidRequest parameter set to the value that it sent to the underlying driver.

NDIS calls MiniportCancelOidRequest at IRQL <= DISPATCH_LEVEL.

See Also

Reference

NDIS OID Request Interface for Connectionless Miniport Drivers
MiniportInitializeEx
NDIS_OID_REQUEST
NdisCancelOidRequest
NdisMRegisterMiniportDriver
NdisMOidRequestComplete