Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt nur für KMDF]
Die WdfFdoInitWdmGetPhysicalDevice Methode ruft das WDM-physische Geräteobjekt (PDO) eines Geräts ab.
Syntax
PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
[in] PWDFDEVICE_INIT DeviceInit
);
Die 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.
Bemerkungen
Der Treiber muss WdfFdoInitWdmGetPhysicalDevice aufrufen, bevor WdfDeviceCreateaufgerufen wird. Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.
Weitere Informationen zur WdfFdoInitWdmGetPhysicalDevice--Methode finden Sie unter Erstellen von Geräteobjekten in einem Funktionstreiber.
Beispiele
Das folgende Codebeispiel ruft einen Zeiger auf eine DEVICE_OBJECT Struktur ab, die den WDM-PDO eines Geräts darstellt.
PDEVICE_OBJECT device;
device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Kopfzeile | wdffdo.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |