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)

Consulte también

WdfDeviceMiniportCreate