Función WdfWdmDeviceGetWdfDeviceHandle (wdfdevice.h)
[Solo se aplica a KMDF]
El método WdfWdmDeviceGetWdfDeviceHandle devuelve un identificador al objeto de dispositivo de marco asociado a un objeto de dispositivo WDM especificado.
Sintaxis
WDFDEVICE WdfWdmDeviceGetWdfDeviceHandle(
[in] PDEVICE_OBJECT DeviceObject
);
Parámetros
[in] DeviceObject
Puntero a una estructura de DEVICE_OBJECT WDM que creó el controlador que llama.
Valor devuelto
Si el objeto de dispositivo WDM especificado es válido, WdfWdmDeviceGetWdfDeviceHandle devuelve un identificador al objeto de dispositivo de marco asociado. De lo contrario, el método devuelve NULL.
Comentarios
WDM DEVICE_OBJECT estructura que el controlador especifica para el parámetro DeviceObject debe representar un objeto de dispositivo que creó el controlador que llama. Por ejemplo, la estructura no puede representar ninguno de los objetos de dispositivo WDM que el controlador especificó en una llamada anterior a WdfDeviceMiniportCreate.
Ejemplos
En el ejemplo de código siguiente se obtiene un identificador para el objeto de dispositivo de marco asociado a un objeto de dispositivo WDM que creó el controlador que realiza la llamada.
WDFDEVICE device;
device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfdevice.h (incluya Wdf.h) |
| Library | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| IRQL | <=DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |