EVT_WDF_REQUEST_CANCEL callback function (wdfrequest.h)

[Applies to KMDF and UMDF]

A driver's EvtRequestCancel event callback function handles operations that must be performed when an I/O request is canceled.

Syntax

EVT_WDF_REQUEST_CANCEL EvtWdfRequestCancel;

void EvtWdfRequestCancel(
  [in] WDFREQUEST Request
)
{...}

Parameters

[in] Request

A handle to a framework request object that represents the I/O request that is being canceled.

Return value

None

Remarks

To register an EvtRequestCancel callback function, the driver must call WdfRequestMarkCancelable or WdfRequestMarkCancelableEx.

When the framework calls your driver's EvtRequestCancel callback function, if the driver can cancel the request, it must:

  1. Finish or stop processing the request, along with subrequests that it might have created.
  2. Call WdfRequestComplete, specifying a status value of STATUS_CANCELLED.
For more information about this callback function, see Canceling I/O Requests.

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfrequest.h (include Wdf.h)
IRQL <=DISPATCH_LEVEL

See also

WdfRequestComplete

WdfRequestMarkCancelable

WdfRequestMarkCancelableEx