Función WdfDriverWdmGetDriverObject (wdfdriver.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDriverWdmGetDriverObject recupera un puntero al objeto del controlador modelo de controlador de Windows (WDM) asociado a un objeto de controlador de marco especificado.

Sintaxis

PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
  [in] WDFDRIVER Driver
);

Parámetros

[in] Driver

Identificador del objeto de controlador del marco de trabajo del controlador que obtuvo el controlador de una llamada anterior a WdfDriverCreate o WdfGetDriver.

Valor devuelto

WdfDriverWdmGetDriverObject devuelve un puntero a una estructura de DRIVER_OBJECT . Se produce una comprobación de errores del sistema si el controlador no es válido.

Comentarios

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

Ejemplos

En el ejemplo de código siguiente se obtiene un puntero al objeto de controlador WDM asociado a un objeto de controlador de marco especificado.

PDRIVER_OBJECT  pDrvObj;

pDrvObj = WdfDriverWdmGetDriverObject(Driver);

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdriver.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)

Consulte también

DRIVER_OBJECT

WdfDriverCreate

WdfGetDriver