WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE函式 (wdfio.h)

發行項
03/01/2024

[適用於 KMDF 和 UMDF]

WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE函式會初始化驅動程式WDF_IO_QUEUE_CONFIG結構。

語法

void WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(
  [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_DEFAULT_QUEUE 。 WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE函式會零指定的WDF_IO_QUEUE_CONFIG結構，並設定其 Size 成員。它也會將 PowerManaged 成員設定為 WdfUseDefault、將 DefaultQueue 成員設定為 TRUE，並將指定的分派類型儲存在 DispatchType 成員中。

從 KMDF 1.9 版開始，如果 DispatchType 設定為 WdfIoQueueDispatchParallel，WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE會將結構的 NumberOfPresentedRequests 成員設定為 -1。這個值表示架構可以將不限數量的 I/O 要求傳遞給驅動程式。

如需使用 WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE 的程式代碼範例，請參閱 WdfIoQueueCreate。