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)

Vedi anche

WdfDeviceWdmGetDeviceObject

WdfDeviceWdmGetPhysicalDevice