WDF_IO_QUEUE_CONFIG_INIT函式 (wdfio.h)

發行項
02/27/2024

[適用於 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
                          );