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
如果发生以下任一情况,则返回此值:
STATUS_WDF_BUSY
指定的 I/O 队列不接受新请求。
 

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

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

注解

在驱动程序可以调用 WdfRequestForwardToParentDeviceIoQueue 之前,它必须调用 WdfPdoInitAllowForwardingRequestToParent

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

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

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

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

有关 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 (请参阅框架库版本控制.)
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf)

另请参阅

WdfPdoInitAllowForwardingRequestToParent