WdfFdoInitWdmGetPhysicalDevice-Funktion (wdffdo.h)

[Gilt nur für KMDF]

Die WdfFdoInitWdmGetPhysicalDevice-Methode ruft das WDM-Objekt (PDO) eines Geräts ab.

Syntax

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT Struktur, die der Treiber aus seiner EvtDriverDeviceAdd-Rückruffunktion abgerufen hat.

Wenn der Vorgang erfolgreich ist, gibt die Methode einen Zeiger auf eine DEVICE_OBJECT-Struktur zurück. Andernfalls gibt die Methode NULL zurück.

Der Treiber muss WdfFdoInitWdmGetPhysicalDevice aufrufen, bevor WdfDeviceCreate aufgerufen wird. Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.

Weitere Informationen zur WdfFdoInitWdmGetPhysicalDevice-Methode finden Sie unter Erstellen von Geräteobjekten in einem Funktionstreiber.

Im folgenden Codebeispiel wird ein Zeiger auf eine DEVICE_OBJECT-Struktur abgerufen, die das WDM-PDO eines Geräts darstellt.

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

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