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