通过

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)
Library Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf) 、 InvalidReqAccess (kmdf) 、 InvalidReqAccessLocal (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另请参阅

WdfRequestCompleteWithInformation

WdfRequestSetInformation