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