WdfDeviceWdmGetPhysicalDevice-Funktion (wdfdevice.h)

[Gilt nur für KMDF]

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

Syntax

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

Die Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

Rückgabewert

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

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

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

Bemerkungen

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

Beispiele

Ein Codebeispiel, das WdfDeviceWdmGetPhysicalDeviceverwendet, finden Sie unter WdfDeviceWdmGetAttachedDevice.

Anforderungen

Anforderung	Wert
Zielplattform	universell
Minimale KMDF-Version	1.0
Kopfzeile	wdfdevice.h (einschließen Wdf.h)
Bibliothek	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)