Función DrvEnableDriver (winddi.h)

Artículo
03/13/2024

La función DrvEnableDriver es el punto de entrada del controlador inicial exportado por el archivo DLL del controlador. Rellena una estructura DRVENABLEDATA con el número de versión DDI de gráficos del controlador y las direcciones de llamada de todas las funciones DDI de gráficos compatibles con el controlador.

Sintaxis

BOOL DrvEnableDriver(
       ULONG         iEngineVersion,
       ULONG         cj,
  [in] DRVENABLEDATA *pded
);

Parámetros

iEngineVersion

Identifica la versión de GDI que se está ejecutando actualmente.

cj

Es el tamaño en bytes de la estructura a la que apunta pded. Si la estructura es mayor de lo esperado, los miembros adicionales deben dejarse sin modificar.

[in] pded

Puntero a una estructura DRVENABLEDATA . GDI inicializa cero bytes cj antes de la llamada. El controlador rellena sus propios datos.

Valor devuelto

El valor devuelto es TRUE si el controlador especificado está habilitado. De lo contrario, es FALSE y se registra un código de error.

Comentarios

DrvEnableDriver debe implementarse en todos los controladores gráficos. Si usas las herramientas de compilación del Kit de controladores de Windows (WDK) y has establecido TARGETTYPE en GDI_DRIVER (consulta Building a Printer Graphics DLL), esta función debe denominarse DrvEnableDriver. Esta es la única función de controlador de visualización a la que se debe tener acceso por nombre. Se accede a todas las demás funciones del controlador de pantalla a través de punteros de función; por lo tanto, sus nombres se presentan en esta documentación como pseudonombres.

Esta función también puede realizar inicializaciones únicas, como la asignación de semáforos. El controlador debe esperar hasta que se llame a DrvEnablePDEV antes de habilitar el hardware, como una pantalla.

Al realizar la comprobación de versiones con el valor proporcionado en iEngineVersion, el controlador debe usar la constante DDI_DRIVER_VERSION_Xxx adecuada (definida en winddi.h) que se muestra en la tabla siguiente. Los controladores casi nunca deben comprobar la igualdad, ya que las nuevas versiones y versiones de Service Pack para el sistema operativo se publicarán en el futuro. Para obtener más información, consulte DRVENABLEDATA.

Valor	Versión de sistema operativo
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 Service Pack 3
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP Service Pack 1