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:
- Finish or stop processing the request, along with subrequests that it might have created.
- Call WdfRequestComplete, specifying a status value of STATUS_CANCELLED.
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 |