Función DrvGetModes (winddi.h)

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.

Window Manager 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 minipuerto.

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 muestra 3Dlabs Permedia2 (3dlabs.htm ) y 3Dlabs Permedia3 (Perm3.htm). Puede obtener estos controladores de ejemplo desde la página Kit de desarrollo de controladores de Windows Server 2003 SP1 (DDK), que puede descargar desde la página DDK - Kit de desarrollo de controladores de Windows del sitio web de WDHC.
 

Requisitos

   
Plataforma de destino Escritorio
Encabezado winddi.h (incluya Winddi.h)

Consulte también

DEVMODEW

DrvAssertMode

DrvEnablePDEV

EngDeviceIoControl