Función WdfDeviceWdmGetDeviceObject (wdfdevice.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDeviceWdmGetDeviceObject devuelve el objeto de dispositivo modelo de controlador de Windows (WDM) asociado a un objeto de dispositivo de marco especificado.

Sintaxis

PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
  WDFDEVICE Device
);

Parámetros

Device

Identificador de un objeto de dispositivo de marco.

Valor devuelto

WdfDeviceWdmGetDeviceObject devuelve un puntero a una estructura de DEVICE_OBJECT .

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

El puntero que devuelve el método WdfDeviceWdmGetDeviceObject es válido hasta que se elimina el objeto de dispositivo de marco. Si el controlador proporciona una función EvtCleanupCallback para el objeto de dispositivo de marco, el puntero es válido hasta que la función de devolución de llamada devuelve.

Ejemplos

En el ejemplo de código siguiente se crea un mensaje de seguimiento que contiene punteros a los objetos de dispositivo WDM que representan el PDO y el FDO de un dispositivo.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            AMCC_TRACE_INIT,
            "PDO 0x%p, FDO 0x%p",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device)
            );

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

WdfDeviceWdmGetPhysicalDevice