WdfDeviceWdmGetAttachedDevice-Funktion (wdfdevice.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfDeviceWdmGetAttachedDevice-Methode gibt das nächstniedrige WDM-Geräteobjekt im Gerätestapel zurück.

Syntax

PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

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

Rückgabewert

WdfDeviceWdmGetAttachedDevice gibt einen Zeiger auf eine WDM-DEVICE_OBJECT-Struktur zurück. Wenn das angegebene Objekthandle ein physisches Geräteobjekt (PDO) darstellt, gibt die Methode NULL zurück.

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

Hinweise

Der Zeiger, den die WdfDeviceWdmGetAttachedDevice-Methode zurückgibt, ist gültig, bis das Frameworkgerä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ückgibt.

Beispiele

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

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            DBG_PNP,
            "PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device),
            WdfDeviceWdmGetAttachedDevice(device)
            );

Anforderungen

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

Weitere Informationen

WdfDeviceWdmGetDeviceObject

WdfDeviceWdmGetPhysicalDevice