WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE-Funktion (wdfio.h)
[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
);
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 Anforderungsverteilungstyp für die Warteschlange identifiziert.
Rückgabewert
Keine
Bemerkungen
Treiber sollten WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE aufrufen, wenn sie eine energieverwaltete E/A-Warteschlange erstellen, bei der es sich um die Standardwarteschlange eines Geräts handelt. Die WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE-Funktion nullt die angegebene WDF_IO_QUEUE_CONFIG-Struktur und legt deren Size-Element fest. Außerdem wird das PowerManaged-Element auf WdfUseDefault festgelegt, das DefaultQueue-Element auf TRUE festgelegt und der angegebene Verteilertyp im DispatchType-Element gespeichert.
Wenn DispatchType ab KMDF-Version 1.9 auf WdfIoQueueDispatchParallel festgelegt ist, legt WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE den NumberOfPresentedRequests-Member der Struktur auf -1 fest. Dieser Wert gibt an, dass das Framework eine unbegrenzte Anzahl von E/A-Anforderungen an den Treiber übermitteln kann.
Ein Codebeispiel, das WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE verwendet, finden Sie unter WdfIoQueueCreate.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfio.h (einschließen von Wdf.h) |