WdfDeviceGetDefaultQueue-Funktion (wdfdevice.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WdfDeviceGetDefaultQueue-Methode gibt ein Handle an die Standard-E/A-Warteschlange eines Geräts zurück.

Syntax

WDFQUEUE WdfDeviceGetDefaultQueue(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode ein Handle an ein Framework-Warteschlangenobjekt zurück. Wenn der Treiber keine Standard-E/A-Warteschlange für das Gerät erstellt hat, gibt die Methode NULL zurück.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Weitere Informationen zu Standard-E/A-Warteschlangen finden Sie unter Erstellen von E/A-Warteschlangen.

Beispiele

Im folgenden Codebeispiel wird ein Handle für die Standard-E/A-Warteschlange eines Geräts abgerufen.

WDFQUEUE DefaultQueue;

DefaultQueue = WdfDeviceGetDefaultQueue(Device);

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über