Funzione WdfWdmDeviceGetWdfDeviceHandle (wdfdevice.h)

[Si applica solo a KMDF]

Il metodo WdfWdmDeviceGetWdfDeviceHandle restituisce un handle all'oggetto dispositivo framework associato a un oggetto dispositivo WDM specificato.

Sintassi

WDFDEVICE WdfWdmDeviceGetWdfDeviceHandle(
  [in] PDEVICE_OBJECT DeviceObject
);

Parametri

[in] DeviceObject

Puntatore a una struttura wdm DEVICE_OBJECT creata dal driver chiamante.

Valore restituito

Se l'oggetto dispositivo WDM specificato è valido, WdfWdmDeviceGetWdfDeviceHandle restituisce un handle all'oggetto dispositivo framework associato. In caso contrario, il metodo restituisce NULL.

Commenti

La struttura di DEVICE_OBJECT WDM specificata dal driver per il parametro DeviceObject deve rappresentare un oggetto dispositivo creato dal driver chiamante. Ad esempio, la struttura non può rappresentare nessuno degli oggetti dispositivo WDM specificati nel driver specificato in una chiamata precedente a WdfDeviceMiniportCreate.

Esempio

Nell'esempio di codice seguente viene ottenuto un handle per l'oggetto dispositivo framework associato a un oggetto dispositivo WDM creato dal driver chiamante.

WDFDEVICE  device;

device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);

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

WdfDeviceMiniportCreate