estructura DISPLAY_DEVICEA (wingdi.h)

La estructura DISPLAY_DEVICE recibe información sobre el dispositivo para mostrar especificado por el parámetro iDevNum de la función EnumDisplayDevices.

Sintaxis

typedef struct _DISPLAY_DEVICEA {
  DWORD cb;
  CHAR  DeviceName[32];
  CHAR  DeviceString[128];
  DWORD StateFlags;
  CHAR  DeviceID[128];
  CHAR  DeviceKey[128];
} DISPLAY_DEVICEA, *PDISPLAY_DEVICEA, *LPDISPLAY_DEVICEA;

Miembros

cb

Tamaño, en bytes, de la estructura DISPLAY_DEVICE. Debe inicializarse antes de llamar a EnumDisplayDevices.

DeviceName[32]

Matriz de caracteres que identifican el nombre del dispositivo. Este es el dispositivo adaptador o el dispositivo de supervisión.

DeviceString[128]

Matriz de caracteres que contiene la cadena de contexto del dispositivo. Se trata de una descripción del adaptador de pantalla o del monitor de visualización.

StateFlags

Marcas de estado del dispositivo. Puede ser cualquier combinación razonable de lo siguiente.

Valor	Significado
DISPLAY_DEVICE_ACTIVE	DISPLAY_DEVICE_ACTIVE especifica si se presenta un monitor como "activado" por la vista GDI correspondiente. Windows Vista: EnumDisplayDevices solo enumerará los monitores que se pueden presentar como "activados".
DISPLAY_DEVICE_MIRRORING_DRIVER	Representa un pseudo device usado para reflejar el dibujo de la aplicación con fines de comunicación remota u otros fines. Un pseudo monitor invisible está asociado a este dispositivo. Por ejemplo, NetMeeting lo usa. Tenga en cuenta que GetSystemMetrics (SM_MONITORS) solo cuentas para monitores de visualización visibles.
DISPLAY_DEVICE_MODESPRUNED	El dispositivo tiene más modos de visualización que su compatibilidad con los dispositivos de salida.
DISPLAY_DEVICE_PRIMARY_DEVICE	El escritorio principal está en el dispositivo. Para un sistema con una sola tarjeta de visualización, siempre se establece. Para un sistema con varias tarjetas de visualización, solo un dispositivo puede tener este conjunto.
DISPLAY_DEVICE_REMOVABLE	El dispositivo es extraíble; no puede ser la pantalla principal.
DISPLAY_DEVICE_VGA_COMPATIBLE	El dispositivo es compatible con VGA.

DeviceID[128]

No se usa.

DeviceKey[128]

Reservado.

Observaciones

Los cuatro miembros de cadena se establecen en función de los parámetros pasados a EnumDisplayDevices. Si el lpDevice parámetro es NULL, DISPLAY_DEVICE se rellena con información sobre los adaptadores de pantalla. Si es un nombre de dispositivo válido, se rellena con información sobre los monitores de ese dispositivo.

Nota

El encabezado wingdi.h define DISPLAY_DEVICE 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]
encabezado de	wingdi.h (incluya Windows.h)

Consulte también

estructuras de contexto de dispositivo de

Información general sobre contextos de dispositivo de

EnumDisplayDevices

GetSystemMetrics