Funzione WdfDeviceWdmGetAttachedDevice (wdfdevice.h)
[Si applica solo a KMDF]
Il metodo WdfDeviceWdmGetAttachedDevice restituisce l'oggetto dispositivo WDM inferiore successivo nello stack di dispositivi.
Sintassi
PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
[in] WDFDEVICE Device
);
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
Valore restituito
WdfDeviceWdmGetAttachedDevice restituisce un puntatore a una struttura di DEVICE_OBJECT WDM. Se l'handle di oggetto specificato rappresenta un oggetto dispositivo fisico (PDO), il metodo restituisce NULL.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Commenti
Il puntatore restituito dal metodo WdfDeviceWdmGetAttachedDevice è valido fino a quando non viene eliminato l'oggetto dispositivo framework. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto dispositivo framework, il puntatore è valido fino a quando non viene restituita la funzione di callback.
Esempio
Nell'esempio di codice seguente viene creato un messaggio di traccia che contiene puntatori agli oggetti dispositivo WDM che rappresentano il PDO, il FDO e il dispositivo inferiore successivo di un dispositivo.
TraceEvents(
TRACE_LEVEL_INFORMATION,
DBG_PNP,
"PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
WdfDeviceWdmGetPhysicalDevice(device),
WdfDeviceWdmGetDeviceObject(device),
WdfDeviceWdmGetAttachedDevice(device)
);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfdevice.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |