WdfDeviceWdmGetAttachedDevice-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Die WdfDeviceWdmGetAttachedDevice Methode gibt das nächste niedrigere WDM-Geräteobjekt im Gerätestapelzurück.
Syntax
PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
[in] WDFDEVICE Device
);
Die Parameter
[in] Device
Ein Handle zu einem 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.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
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ückgegeben wird.
Beispiele
Im folgenden Codebeispiel wird eine Ablaufverfolgungsmeldung erstellt, die Zeiger auf die WDM-Geräteobjekte enthält, die die PDO-, FDO- und next-Lower-Geräte 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 |
| Minimale KMDF-Version | 1.0 |
| Kopfzeile | wdfdevice.h (einschließen Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |