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