WdfDeviceWdmGetPhysicalDevice-Funktion (wdfdevice.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfDeviceWdmGetPhysicalDevice-Methode ruft die WDM-PDO des physischen Geräts aus dem Gerätestapel ab.

Syntax

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

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

Rückgabewert

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

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

WdfDeviceWdmGetPhysicalDevice gibt NULL zurück, wenn der Aufrufer ein Steuerelementgerätobjekt bereitstellt.

Hinweise

Der Zeiger, den die WdfDeviceWdmGetPhysicalDevice-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ückgibt.

Beispiele

Ein Codebeispiel, das WdfDeviceWdmGetPhysicalDevice verwendet, finden Sie unter WdfDeviceWdmGetAttachedDevice.

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)