WdfRequestSetInformation 函数 (wdfrequest.h)
[适用于 KMDF 和 UMDF]
WdfRequestSetInformation 方法为指定的 I/O 请求设置完成状态信息。
语法
void WdfRequestSetInformation(
[in] WDFREQUEST Request,
[in] ULONG_PTR Information
);
参数
[in] Request
框架请求对象的句柄。
[in] Information
请求的驱动程序定义的完成状态信息。
返回值
无
备注
如果驱动程序提供无效的对象句柄,则会发生 bug 检查。
基于框架的驱动程序使用 WdfRequestSetInformation 方法提供与 I/O 请求完成相关的特定于驱动程序的信息,例如传输的字节数。 其他驱动程序可以通过调用 WdfRequestGetInformation 来获取此信息。
驱动程序还可以通过调用 WdfRequestCompleteWithInformation 来指定完成状态信息。
有关 WdfRequestSetInformation 的详细信息,请参阅 完成 I/O 请求。
示例
下面的代码示例基于 EvtIoDeviceControl 回调函数接收的 I/O 控制代码的值设置请求完成信息。
VOID
MyEvtIoDeviceControl(
IN WDFQUEUE Queue,
IN WDFREQUEST Request,
IN size_t OutputBufferLength,
IN size_t InputBufferLength,
IN ULONG IoControlCode
)
{
switch (IoControlCode) {
case MY_IOCTL_CODE_1:
WdfRequestSetInformation(
Request,
VALUE_1
);
status = STATUS_SUCCESS;
break;
case MY_IOCTL_CODE_2:
WdfRequestSetInformation(
Request,
VALUE_2
);
status = STATUS_SUCCESS;
break;
case MY_IOCTL_CODE_3:
WdfRequestSetInformation(
Request,
VALUE_3
);
status = STATUS_SUCCESS;
break;
default:
status = STATUS_INVALID_DEVICE_REQUEST;
break;
}
WdfRequestComplete(
Request,
status
);
}
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 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) |