WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE-Funktion (wdfio.h)

Artikel
03/22/2025

[Gilt für KMDF und UMDF]

Die WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE-Funktion initialisiert die WDF_IO_QUEUE_CONFIG Struktur eines Treibers.

Syntax

void WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(
  [out] PWDF_IO_QUEUE_CONFIG       Config,
  [in]  WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);

Die Parameter

[out] Config

Ein Zeiger auf die WDF_IO_QUEUE_CONFIG Struktur des Treibers.

[in] DispatchType

Ein WDF_IO_QUEUE_DISPATCH_TYPE Enumerator, der den Anforderungsversandtyp für die Warteschlange identifiziert.

Rückgabewert

Nichts

Bemerkungen

Treiber sollten WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE aufrufen, wenn sie eine powerverwaltete E/A-Warteschlange erstellen, bei der es sich um die Standardwarteschlange eines Geräts handelt. Die WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE-Funktion stellt die angegebene WDF_IO_QUEUE_CONFIG Struktur null und legt dessen Size-Element fest. Außerdem wird das PowerManaged Member auf WdfUseDefault-festgelegt, das DefaultQueue Member auf TRUEfestgelegt und der angegebene Verteilertyp im DispatchType Member gespeichert.

Ab KMDF,Version 1.9, wenn DispatchType- auf WdfIoQueueDispatchParallelfestgelegt ist, legt WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE die NumberOfPresentedRequests Member der Struktur auf -1 fest. Dieser Wert gibt an, dass das Framework eine unbegrenzte Anzahl von E/A-Anforderungen an den Treiber liefern kann.

Ein Codebeispiel, das WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUEverwendet, finden Sie unter WdfIoQueueCreate.