EVT_WDF_REQUEST_CANCEL回调函数 (wdfrequest.h)
[适用于 KMDF 和 UMDF]
驱动程序的 EvtRequestCancel 事件回调函数处理在取消 I/O 请求时必须执行的操作。
语法
EVT_WDF_REQUEST_CANCEL EvtWdfRequestCancel;
void EvtWdfRequestCancel(
[in] WDFREQUEST Request
)
{...}
参数
[in] Request
表示正在取消的 I/O 请求的框架请求对象的句柄。
返回值
无
备注
若要注册 EvtRequestCancel 回调函数，驱动程序必须调用 WdfRequestMarkCancelable 或 WdfRequestMarkCancelableEx。
当框架调用驱动程序的 EvtRequestCancel 回调函数时，如果驱动程序可以取消请求，则必须：
- 完成或停止处理请求，以及它可能已创建的子请求。
- 调用 WdfRequestComplete，将状态值指定为 STATUS_CANCELLED。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 标头 | wdfrequest.h (包括 Wdf.h) |
| IRQL | <=DISPATCH_LEVEL |