通过

WdfRequestGetInformation 函数 （wdfrequest.h）

  • 项目

[适用于 KMDF 和 UMDF]

WdfRequestGetInformation 方法返回指定 I/O 请求的完成状态信息。

语法

ULONG_PTR WdfRequestGetInformation(
  [in] WDFREQUEST Request
);

参数

[in] Request

框架请求对象的句柄。

返回值

WdfRequestGetInformation 通过调用 WdfRequestSetInformation 或 WdfRequestCompleteWithInformation返回较低级别的驱动程序设置的信息。

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

言论

驱动程序可以调用 WdfRequestSetInformation 或 WdfRequestCompleteWithInformation 来设置 I/O 请求的完成状态信息。 驱动程序可以在较低级别驱动程序完成请求后调用 WdfRequestGetInformation，以获取较低级别的驱动程序设置的完成状态信息。

如果驱动程序在调用 WdfRequestComplete 以完成请求后调用 WdfRequestGetInformation，WdfRequestGetInformation 返回 NULL。

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

例子

下面的代码示例将 I/O 请求发送到 I/O 目标，然后获取 I/O 目标提供的状态信息。

ULONG_PTR  informationRetrieved = NULL;

status = WdfIoTargetSendWriteSynchronously(
                                           ioTarget,
                                           request,
                                           &outputMemoryDescriptor,
                                           NULL,
                                           NULL,
                                           &bytesWritten
                                           );
if (NT_SUCCESS(status)) {
    informationRetrieved = WdfRequestGetInformation(request);
}

要求

要求 价值
目标平台 普遍
最低 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）

另请参阅

WdfRequestCompleteWithInformation

WdfRequestSetInformation