WdfDeviceWdmGetDeviceObject-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Die WdfDeviceWdmGetDeviceObject-Methode gibt das WDM-Geräteobjekt (Windows Driver Model) zurück, das einem angegebenen Framework-Geräteobjekt zugeordnet ist.
Syntax
PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
WDFDEVICE Device
);
Parameter
Device
Ein Handle für ein Framework-Geräteobjekt.
Rückgabewert
WdfDeviceWdmGetDeviceObject gibt einen Zeiger auf eine DEVICE_OBJECT-Struktur zurück.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Der Zeiger, den die WdfDeviceWdmGetDeviceObject-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ückgegeben wird.
Beispiele
Im folgenden Codebeispiel wird eine Ablaufverfolgungsmeldung erstellt, die Zeiger auf die WDM-Geräteobjekte enthält, die die PDO und FDO eines Geräts darstellen.
TraceEvents(
TRACE_LEVEL_INFORMATION,
AMCC_TRACE_INIT,
"PDO 0x%p, FDO 0x%p",
WdfDeviceWdmGetPhysicalDevice(device),
WdfDeviceWdmGetDeviceObject(device)
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |