WdfRequestForwardToParentDeviceIoQueue 函数 (wdfrequest.h)

  • 项目

[仅适用于 KMDF]

WdfRequestForwardToParentDeviceIoQueue 方法将子设备的 I/O 队列中的 I/O 请求重新排队到子设备的父设备的指定 I/O 队列。

语法

NTSTATUS WdfRequestForwardToParentDeviceIoQueue(
  [in] WDFREQUEST                   Request,
  [in] WDFQUEUE                     ParentDeviceQueue,
  [in] PWDF_REQUEST_FORWARD_OPTIONS ForwardOptions
);

参数

[in] Request

框架请求对象的句柄。

[in] ParentDeviceQueue

框架队列对象的句柄。

[in] ForwardOptions

指向调用方分配 的WDF_REQUEST_FORWARD_OPTIONS 结构的指针。

返回值

如果操作成功，WdfRequestForwardToParentDeviceIoQueue 将返回STATUS_SUCCESS。 否则，此方法可能会返回以下值之一：

返回代码 说明
STATUS_INFO_LENGTH_MISMATCH
 提供的WDF_REQUEST_FORWARD_OPTIONS结构的大小无效。
STATUS_INVALID_PARAMETER
 提供的 WDF_REQUEST_FORWARD_OPTIONS 结构的成员包含无效值。
STATUS_INVALID_DEVICE_REQUEST
 如果发生以下情况之一，则返回此值：
  • 驱动程序未从 I/O 队列获取 I/O 请求。
  • 源和目标 I/O 队列是相同的。
  • 指定的 I/O 队列不属于父设备。
  • 驱动程序已启用 保证向前进度 ，并且指定的 I/O 请求是为内存不足的情况保留的。
  • 驱动程序未调用 WdfPdoInitAllowForwardingRequestToParent。
STATUS_WDF_BUSY
 指定的 I/O 队列不接受新请求。
 

此方法还可能返回其他 NTSTATUS 值。

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

注解

在驱动程序调用 WdfRequestForwardToParentDeviceIoQueue 之前，它必须调用 WdfPdoInitAllowForwardingRequestToParent。

驱动程序必须使用相同的方法来访问父设备和子设备 (缓冲、直接或不) 的数据缓冲区 。

如果驱动程序将调用 WdfRequestForwardToParentDeviceIoQueue 来重新排队 I/O 请求，则驱动程序不得使用请求对象作为其他框架对象的父对象，例如计时器对象或工作项对象。

如果驱动程序已调用 WdfDeviceInitSetRequestAttributes 来指定父设备的请求对象的上下文空间，则框架不会添加此上下文空间来请求驱动程序在子设备队列中接收的对象。 驱动程序可以调用 WdfObjectAllocateContext ，以在驱动程序调用 WdfRequestForwardToParentDeviceIoQueue 之前将上下文空间添加到请求对象。 另一方面，如果驱动程序为子设备的请求对象调用了 WdfDeviceInitSetRequestAttributes，并且父设备的请求对象使用的上下文空间等于或小于子设备的上下文空间，则驱动程序可以使用请求对象的上下文空间，而无需调用 WdfObjectAllocateContext。

目前，驱动程序必须为所有重新排队的 I/O 请求使用 send and forget 选项 。 因此，请注意，在框架删除重新排队的请求对象时，它可能已经删除了最初接收请求对象的子设备。 因此，驱动程序不得使用重新排队的请求对象的 EvtCleanupCallback 或 EvtDestroyCallback 函数来访问子设备资源，因为在 EvtCleanupCallback 或 EvtDestroyCallback 函数运行之前，可能会删除这些资源。

有关 WdfRequestForwardToParentDeviceIoQueue 的详细信息，请参阅 重新排队 I/O 请求。

示例

下面的代码示例首先确定接收 I/O 请求的设备的父设备，然后将 I/O 请求重新排队到父设备的默认 I/O 队列。

WDFDEVICE device, parentDevice;
WDF_REQUEST_FORWARD_OPTIONS forwardOptions;
NTSTATUS status;

device = WdfIoQueueGetDevice(WdfRequestGetIoQueue(Request));
parentDevice = WdfPdoGetParent(device);

WDF_REQUEST_FORWARD_OPTIONS_INIT(&forwardOptions);
status = WdfRequestForwardToParentDeviceIoQueue(
             Request,
             WdfDeviceGetDefaultQueue(parentDevice),
             &forwardOptions
             );
if (!NT_SUCCESS(status)) {
    WdfRequestComplete(
                       Request,
                       status
                       );
  }

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.9
标头 wdfrequest.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库 Versioning.)
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf)

另请参阅

WdfPdoInitAllowForwardingRequestToParent