Share via

estrutura DISPLAY_DEVICEA (wingdi.h)

  • Artigo

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 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 "ativado" pela respectiva exibição de GDI. Windows Vista: EnumDisplayDevices só enumerará monitores que podem ser apresentados como "ativados".
DISPLAY_DEVICE_MIRRORING_DRIVER Representa um pseudo dispositivo usado para espelho desenho de aplicativo para comunicação remota ou outras finalidades. Um pseudo monitor invisível está associado a este dispositivo. Por exemplo, o NetMeeting o usa. Observe que GetSystemMetrics (SM_MONITORS) conta apenas 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 uma única 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.

Comentários

Os quatro membros de cadeia de caracteres são definidos com base nos parâmetros passados para EnumDisplayDevices. Se o parâmetro 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.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho wingdi.h (inclua Windows.h)

Confira também

Estruturas de contexto do dispositivo

Visão geral dos contextos do dispositivo

Enumdisplaydevices

GetSystemMetrics