Función DrvGetModes (winddi.h)

Artículo
03/04/2024

La función DrvGetModes enumera los modos admitidos por un dispositivo determinado.

Sintaxis

ULONG DrvGetModes(
  [in]            HANDLE   hDriver,
                  ULONG    cjSize,
  [out, optional] DEVMODEW *pdm
);

Parámetros

[in] hDriver

Identificador del controlador para el que se deben enumerar los modos. Este es el identificador pasado en el parámetro hDriver de la función DrvEnablePDEV .

cjSize

Especifica el tamaño en bytes del búfer al que apunta pdm.

[out, optional] pdm

Puntero al búfer que contiene estructuras DEVMODEW para que el controlador rellene o NULL.

Valor devuelto

El controlador debe devolver el número de bytes escritos en el búfer si pdm no es NULL. Si pdm es NULL, el controlador debe devolver el número de bytes necesarios para contener todos los datos del modo. El controlador debe devolver cero si se produce un error.

Comentarios

Esta función debe implementarse en todos los controladores de pantalla.

El Administrador de ventanas carga dinámicamente todos los controladores de pantalla asociados a un controlador de minipuerto (basado en la clave InstalledDisplayDrivers del Registro). Se llama a cada controlador de pantalla para recuperar la lista de modos admitidos por esa combinación de controladores cargados. Por ejemplo, el controlador de pantalla VGA64K solo devuelve los modos de color de 64K que se devolvieron en la lista de modos obtenidos del controlador de miniport.

Se puede llamar a DrvGetModes antes de que haya un PDEV activo.

Consulte los ejemplos de Permedia para ver una implementación en funcionamiento de DrvGetModes.

Nota El Kit de controladores de Microsoft Windows (WDK) no contiene los controladores de visualización de ejemplo 3Dlabs Permedia2 (3dlabs.htm ) y 3Dlabs Permedia3 (Perm3.htm). Puedes obtener estos controladores de ejemplo desde el Kit de desarrollo de controladores de Windows Server 2003 SP1 (DDK), que puedes descargar desde la página DDK - Kit de desarrollo de controladores de Windows del sitio web de WDHC.