Función EnumDisplaySettingsA (winuser.h)

Artículo
11/20/2024

La función EnumDisplaySettings recupera información sobre uno de los modos gráficos de un dispositivo de visualización. Para recuperar información de todos los modos gráficos de un dispositivo de visualización, realice una serie de llamadas a esta función.

Nota Aplicaciones que diseñes para tener Como destino Windows 8 y versiones posteriores ya no pueden consultar ni establecer modos de visualización inferiores a 32 bits por píxel (bpp); estas operaciones producirán un error. Estas aplicaciones tienen un manifiesto de compatibilidad que tiene como destino Windows 8. Windows 8 todavía admite modos de color de 8 y 16 bits para aplicaciones de escritorio creadas sin un manifiesto de Windows 8; Windows 8 emula estos modos, pero sigue funcionando en modo de color de 32 bits.

Sintaxis

BOOL EnumDisplaySettingsA(
  [in]  LPCSTR   lpszDeviceName,
  [in]  DWORD    iModeNum,
  [out] DEVMODEA *lpDevMode
);

Parámetros

[in] lpszDeviceName

Puntero a una cadena terminada en null que especifica el dispositivo para mostrar sobre el modo gráfico en el que la función obtendrá información.

Este parámetro es NULL o un DISPLAY_DEVICE.DeviceName devuelto desde EnumDisplayDevices. Un valor NULL especifica el dispositivo para mostrar actual en el equipo en el que se ejecuta el subproceso que realiza la llamada.

[in] iModeNum

Tipo de información que se va a recuperar. Este valor puede ser un índice de modo gráfico o uno de los siguientes valores.

Valor	Significado
ENUM_CURRENT_SETTINGS	Recupere la configuración actual del dispositivo para mostrar.
ENUM_REGISTRY_SETTINGS	Recupere la configuración del dispositivo para mostrar que se almacena actualmente en el Registro.

Los índices del modo gráfico comienzan en cero. Para obtener información de todos los modos gráficos de un dispositivo de visualización, realice una serie de llamadas a EnumDisplaySettings, como se indica a continuación: Establezca iModeNum en cero para la primera llamada e incremente iModeNum por una para cada llamada subsiguiente. Continúe llamando a la función hasta que el valor devuelto sea cero.

Al llamar a EnumDisplaySettings con iModeNum establecido en cero, el sistema operativo inicializa y almacena en caché información sobre el dispositivo para mostrar. Al llamar a EnumDisplaySettings con iModeNum establecido en un valor distinto de cero, la función devuelve la información almacenada en caché la última vez que se llamó a la función con iModeNum establecido en cero.

[out] lpDevMode

Puntero a una estructura DEVMODE en la que la función almacena información sobre el modo gráfico especificado. Antes de llamar a EnumDisplaySettings, establezca el miembro dmSize en sizeof(DEVMODE)y establezca el miembro dmDriverExtra para indicar el tamaño, en bytes, del espacio adicional disponible para recibir datos del controlador privado.

La función EnumDisplaySettings establece valores para los cinco miembros DEVMODE siguientes:

dmBitsPerPel de
dmPelsWidth
dmPelsHeight
dmDisplayFlags
dmDisplayFrequency

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero.

Observaciones

Se produce un error en la función si iModeNum es mayor que el índice del último modo gráfico del dispositivo de visualización. Como se indica en la descripción del parámetro iModeNum, puede usar este comportamiento para enumerar todos los modos gráficos de un dispositivo de visualización.

Virtualización de PPP de

Esta API no participa en la virtualización de PPP. La salida dada siempre está en términos de píxeles físicos y no está relacionada con el contexto de llamada.

Nota

El encabezado winuser.h define EnumDisplaySettings como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll
conjunto de API de	ext-ms-win-ntuser-sysparams-ext-l1-1-0 (introducido en Windows 8)