共用方式為


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_INITWDF_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
                          );

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfio.h (包含 Wdf.h)

另請參閱

WDF_IO_QUEUE_CONFIG

WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE

WDF_IO_QUEUE_DISPATCH_TYPE

WdfIoQueueCreate