estructura DISPLAY_DEVICEA (wingdi.h)

  • Artículo

La estructura DISPLAY_DEVICE recibe información sobre el dispositivo de visualización 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 pantalla.

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 un monitor se presenta 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-dispositivo utilizado 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 tiene 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 presentació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.

Comentarios

Los cuatro miembros de cadena se establecen en función de los parámetros pasados a EnumDisplayDevices. Si el parámetro lpDevice 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 Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado wingdi.h (incluye Windows.h)

Consulte también

Estructuras de contexto de dispositivo

Información general sobre contextos de dispositivo

EnumDisplayDevices

GetSystemMetrics