WdfIoQueueCreate 函数 （wdfio.h）

[适用于 KMDF 和 UMDF]

WdfIoQueueCreate 方法为指定设备创建和配置 I/O 队列。

语法

NTSTATUS WdfIoQueueCreate(
  [in]            WDFDEVICE              Device,
  [in]            PWDF_IO_QUEUE_CONFIG   Config,
  [in, optional]  PWDF_OBJECT_ATTRIBUTES QueueAttributes,
  [out, optional] WDFQUEUE               *Queue
);

参数

[in] Device

队列将与之关联的框架设备对象的句柄。

[in] Config

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

[in, optional] QueueAttributes

指向调用方分配 WDF_OBJECT_ATTRIBUTES 结构的指针，该结构指定新对象的对象属性。 此参数是可选的，可以WDF_NO_OBJECT_ATTRIBUTES。

[out, optional] Queue

指向接收框架队列对象的句柄的位置的指针。

返回值

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

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

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

注解

每次调用 WdfIoQueueCreate 都会为设备创建 I/O 队列。 驱动程序可以为每个设备创建多个 I/O 队列。

配置 和 QueueAttributes 参数指定队列的配置和对象属性。

默认情况下，Device 参数指定的框架设备对象将成为新框架队列对象的父对象。 如果驱动程序在 WDF_OBJECT_ATTRIBUTES 结构的 ParentObject 成员中指定父对象，则父对象可以是框架设备对象或任何父对象，其父级链导致框架设备对象。 框架在删除父对象时将删除队列对象。

如果驱动程序为框架队列对象提供 EvtCleanupCallback 或 EvtDestroyCallback 回调函数，框架会在 IRQL = PASSIVE_LEVEL 调用这些回调函数。

有关 WdfIoQueueCreate的详细信息，请参阅 创建 I/O 队列。

例子

以下代码示例是创建设备默认 I/O 队列的 EvtDriverDeviceAdd 回调函数的节。 该示例初始化 WDF_IO_QUEUE_CONFIG 结构，然后调用 WdfIoQueueCreate。

NTSTATUS
MyEvtDriverDeviceAdd(
    IN WDFDRIVER  Driver,
    IN PWDFDEVICE_INIT  DeviceInit
    )
{
    WDF_IO_QUEUE_CONFIG  ioQueueConfig;
    WDFQUEUE  hQueue;
...
    WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(
                                           &ioQueueConfig,
                                           WdfIoQueueDispatchSequential
                                           );

    ioQueueConfig.EvtIoDefault = MyEvtIoDefault;

    status = WdfIoQueueCreate(
                              device,
                              &ioQueueConfig,
                              WDF_NO_OBJECT_ATTRIBUTES,
                              &hQueue
                              );
    if (!NT_SUCCESS (status)) {
        return status;
    }
...
}

要求

另请参阅

WDF_IO_QUEUE_CONFIG

WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE

WDF_OBJECT_ATTRIBUTES

WdfDeviceConfigureRequestDispatching

WdfRequestForwardToIoQueue