WDF_IO_QUEUE_CONFIG_INIT 函数 (wdfio.h)
[适用于 KMDF 和 UMDF]
WDF_IO_QUEUE_CONFIG_INIT 函数初始化驱动程序的WDF_IO_QUEUE_CONFIG结构。
语法
void WDF_IO_QUEUE_CONFIG_INIT(
[out] PWDF_IO_QUEUE_CONFIG Config,
[in] WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);
参数
[out] Config
指向驱动程序 WDF_IO_QUEUE_CONFIG 结构的指针。
[in] DispatchType
标识队列的请求调度类型的 WDF_IO_QUEUE_DISPATCH_TYPE 枚举器。
返回值
无
备注
驱动程序应在创建不是设备的默认队列的电源托管 I/O 队列时调用 WDF_IO_QUEUE_CONFIG_INIT 。 WDF_IO_QUEUE_CONFIG_INIT函数将指定的WDF_IO_QUEUE_CONFIG结构归零并设置其 Size 成员。 它还将 PowerManaged 成员设置为 WdfUseDefault ,并将指定的调度类型存储在 DispatchType 成员中。
从 KMDF 版本 1.9 开始,如果 DispatchType 设置为 WdfIoQueueDispatchParallel,WDF_IO_QUEUE_CONFIG_INIT将结构的 NumberOfPresentedRequests 成员设置为 -1。 此值指示框架可以向驱动程序传递无限数量的 I/O 请求。
示例
下面的代码示例初始化 WDF_IO_QUEUE_CONFIG 结构,然后调用 WdfIoQueueCreate。
WDF_IO_QUEUE_CONFIG queueConfig;
NTSTATUS status = STATUS_SUCCESS;
WDFQUEUE readQueue;
WDF_IO_QUEUE_CONFIG_INIT(
&queueConfig,
WdfIoQueueDispatchManual
);
status = WdfIoQueueCreate(
hDevice,
&queueConfig,
WDF_NO_OBJECT_ATTRIBUTES,
&readQueue
);
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | wdfio.h (包括 Wdf.h) |