WdfFdoInitWdmGetPhysicalDevice-Funktion (wdffdo.h)

  • Artikel

[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
);

Parameter

[in] DeviceInit

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

Rückgabewert

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

Hinweise

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.

Beispiele

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);

Anforderungen

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)