Funzione WdfDeviceWdmGetDeviceObject (wdfdevice.h)

Articolo
02/27/2024

[Si applica solo a KMDF]

Il metodo WdfDeviceWdmGetDeviceObject restituisce l'oggetto dispositivo Windows Driver Model (WDM) associato a un oggetto dispositivo framework specificato.

Sintassi

PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
  WDFDEVICE Device
);

Parametri

Device

Handle per un oggetto dispositivo framework.

Valore restituito

WdfDeviceWdmGetDeviceObject restituisce un puntatore a una struttura DEVICE_OBJECT .

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Il puntatore restituito dal metodo WdfDeviceWdmGetDeviceObject è valido finché l'oggetto dispositivo framework non viene eliminato. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto dispositivo framework, il puntatore è valido finché 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 l'oggetto PDO e FDO di un dispositivo.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            AMCC_TRACE_INIT,
            "PDO 0x%p, FDO 0x%p",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device)
            );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	Wdf01000.sys (vedere Framework Library Versioning).
IRQL	<=DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfDeviceWdmGetPhysicalDevice

Condividi tramite