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 回调函数时，如果驱动程序可以取消请求，则必须：

  1. 完成或停止处理请求，以及它可能已创建的子请求。
  2. 调用 WdfRequestComplete，将状态值指定为 STATUS_CANCELLED。
有关此回调函数的详细信息，请参阅 取消 I/O 请求。

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfrequest.h (包括 Wdf.h)
IRQL <=DISPATCH_LEVEL

另请参阅

WdfRequestComplete

WdfRequestMarkCancelable

WdfRequestMarkCancelableEx