estrutura DISPLAY_DEVICEA (wingdi.h)

Artigo
11/20/2024

A estrutura DISPLAY_DEVICE recebe informações sobre o dispositivo de exibição especificado pelo parâmetro iDevNum da função EnumDisplayDevices.

Sintaxe

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;

Membros

cb

Tamanho, em bytes, da estrutura DISPLAY_DEVICE. Isso deve ser inicializado antes de chamar EnumDisplayDevices.

DeviceName[32]

Uma matriz de caracteres que identifica o nome do dispositivo. Esse é o dispositivo do adaptador ou o dispositivo monitor.

DeviceString[128]

Uma matriz de caracteres que contém a cadeia de caracteres de contexto do dispositivo. Essa é uma descrição do adaptador de exibição ou do monitor de exibição.

StateFlags

Sinalizadores de estado do dispositivo. Pode ser qualquer combinação razoável do seguinte.

Valor	Significado
DISPLAY_DEVICE_ACTIVE	DISPLAY_DEVICE_ACTIVE especifica se um monitor é apresentado como sendo "ativado" pelo respectivo modo de exibição GDI. Windows Vista: EnumDisplayDevices só enumerará monitores que podem ser apresentados como "ativados".
DISPLAY_DEVICE_MIRRORING_DRIVER	Representa um pseudo dispositivo usado para espelhar o desenho do aplicativo para comunicação remota ou outras finalidades. Um pseudo monitor invisível está associado a este dispositivo. Por exemplo, NetMeeting o usa. Observe que GetSystemMetrics (SM_MONITORS) conta somente para monitores de exibição visíveis.
DISPLAY_DEVICE_MODESPRUNED	O dispositivo tem mais modos de exibição do que seu suporte a dispositivos de saída.
DISPLAY_DEVICE_PRIMARY_DEVICE	A área de trabalho primária está no dispositivo. Para um sistema com um único cartão de exibição, isso é sempre definido. Para um sistema com vários cartões de exibição, apenas um dispositivo pode ter esse conjunto.
DISPLAY_DEVICE_REMOVABLE	O dispositivo é removível; não pode ser a exibição primária.
DISPLAY_DEVICE_VGA_COMPATIBLE	O dispositivo é compatível com VGA.

DeviceID[128]

Não usado.

DeviceKey[128]

Reservado.

Observações

Os quatro membros da cadeia de caracteres são definidos com base nos parâmetros passados para EnumDisplayDevices. Se o lpDevice for NULL, DISPLAY_DEVICE será preenchido com informações sobre os adaptadores de exibição. Se for um nome de dispositivo válido, ele será preenchido com informações sobre os monitores desse dispositivo.

Nota

O cabeçalho wingdi.h define DISPLAY_DEVICE como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	wingdi.h (inclua Windows.h)

Consulte também

estruturas de contexto do dispositivo

Visão geral dos contextos do dispositivo

EnumDisplayDevices

GetSystemMetrics

Compartilhar via