WdfDeviceWdmGetDeviceObject-Funktion (wdfdevice.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfDeviceWdmGetDeviceObject-Methode gibt das WDM-Geräteobjekt (Windows Driver Model) zurück, das einem angegebenen Framework-Geräteobjekt zugeordnet ist.

Syntax

PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
  WDFDEVICE Device
);

Parameter

Device

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

Rückgabewert

WdfDeviceWdmGetDeviceObject gibt einen Zeiger auf eine DEVICE_OBJECT-Struktur zurück.

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

Hinweise

Der Zeiger, den die WdfDeviceWdmGetDeviceObject-Methode zurückgibt, ist gültig, bis das Framework-Geräteobjekt gelöscht wird. Wenn der Treiber eine EvtCleanupCallback-Funktion für das Framework-Geräteobjekt bereitstellt, ist der Zeiger gültig, bis die Rückruffunktion zurückgegeben wird.

Beispiele

Im folgenden Codebeispiel wird eine Ablaufverfolgungsmeldung erstellt, die Zeiger auf die WDM-Geräteobjekte enthält, die die PDO und FDO eines Geräts darstellen.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            AMCC_TRACE_INIT,
            "PDO 0x%p, FDO 0x%p",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device)
            );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfDeviceWdmGetPhysicalDevice