WdfRequestSetCompletionRoutine 函数 (wdfrequest.h)

  • 项目

[适用于 KMDF 和 UMDF]

WdfRequestSetCompletionRoutine 方法注册或取消注册指定的框架请求对象的完成例程。

语法

void WdfRequestSetCompletionRoutine(
  [in]           WDFREQUEST                         Request,
  [in, optional] PFN_WDF_REQUEST_COMPLETION_ROUTINE CompletionRoutine,
  [in, optional] __drv_aliasesMem WDFCONTEXT        CompletionContext
);

参数

[in] Request

框架请求对象的句柄。

[in, optional] CompletionRoutine

指向 CompletionRoutine 回调函数的指针（如果驱动程序正在注册完成例程，或者驱动程序的 NULL 正在取消注册以前注册的完成例程）。

[in, optional] CompletionContext

指向框架传递给 CompletionRoutine 回调函数的驱动程序定义上下文信息的非类型化指针。 此参数是可选的，可以为 NULL。

返回值

无

备注

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

如果驱动程序转发 I/O 请求，但如果你希望在较低级别的驱动程序完成请求时通知驱动程序，则驱动程序可以提供 CompletionRoutine 回调函数并调用 WdfRequestSetCompletionRoutine 来注册该函数。 框架在较低级别的驱动程序完成 I/O 请求后调用回调函数。

有关 WdfRequestSetCompletionRoutine 的详细信息，请参阅 完成 I/O 请求。

示例

有关使用 WdfRequestSetCompletionRoutine 的代码示例，请参阅 WdfRequestSend。

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfrequest.h (包括 Wdf.h)
Library Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf) 、 InvalidReqAccess (kmdf) 、 InvalidReqAccessLocal (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) ， ReqCompletionRoutine (kmdf)

另请参阅

CompletionRoutine