WDF_IO_QUEUE_CONFIG_INIT-Funktion (wdfio.h)

[Gilt für KMDF und UMDF]

Die WDF_IO_QUEUE_CONFIG_INIT-Funktion initialisiert die WDF_IO_QUEUE_CONFIG Struktur eines Treibers.

Syntax

VOID WDF_IO_QUEUE_CONFIG_INIT(
  [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 aufrufen, wenn eine powerverwaltete E/A-Warteschlange erstellt wird, bei der es sich nicht um die Standardwarteschlange eines Geräts handelt. Die funktion WDF_IO_QUEUE_CONFIG_INIT nullt die angegebene WDF_IO_QUEUE_CONFIG Struktur und legt dessen Size member fest. Außerdem wird das PowerManaged Member auf WdfUseDefault- festgelegt und der angegebene Verteilertyp im DispatchType--Element gespeichert.

Ab KMDF,Version 1.9, wenn DispatchType- auf WdfIoQueueDispatchParallelfestgelegt ist, legt WDF_IO_QUEUE_CONFIG_INIT 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.

Beispiele

Im folgenden Codebeispiel wird WDF_IO_QUEUE_CONFIG Struktur initialisiert und anschließend WdfIoQueueCreateaufgerufen.

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

Anforderungen

Siehe auch

WDF_IO_QUEUE_CONFIG

WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE

WDF_IO_QUEUE_DISPATCH_TYPE

WdfIoQueueCreate