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 un WDM DEVICE_OBJECT estructura 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.

Observaciones

La estructura DEVICE_OBJECT WDM 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 especificados 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

Consulte también

WdfDeviceMiniportCreate