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） |
| 库 | Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF） |
| IRQL | <=DISPATCH_LEVEL |
| DDI 符合性规则 | DriverCreate（kmdf），InvalidReqAccess（kmdf），InvalidReqAccessLocal（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf），ReqCompletionRoutine（kmdf） |