EnumDisplayDevices

9/9/2008

Essa função obtém informações sobre os dispositivos exibir em um sistema.

Syntax

BOOL EnumDisplayDevices(
  LPCTSTR lpDevice, 
  DWORD iDevNum, 
  PDISPLAY_DEVICE lpDisplayDevice, 
  DWORD dwFlags 
);

Parameters

• lpDevice
  [no] Ponteiro ao nome do dispositivo.

  Se NULL, a função retorna informações para os dispositivos exibir no sistema, com base em iDevNum.

  Para obter mais informações, consulte " Comentários ".

• iDevNum
  [no] Valor de índice que especifica o dispositivo exibir de interesse.

  O sistema operacional identifica cada dispositivo exibir com um valor índice.

  Os valores índice são inteiros consecutivos, começando em 0.

  Se um sistema tem três dispositivos exibir, de exemplo, eles são especificados pela valores de índice 0, 1 e 2.

• lpDisplayDevice
  [out] Ponteiro para um DISPLAY_DEVICE estrutura que recebe informações sobre o dispositivo exibir especificado por iDevNum.

  Antes chamado EnumDisplayDevices, você deve inicializar a cb membro de DISPLAY_DEVICE Para o tamanho, em bytes, de DISPLAY_DEVICE.

• dwFlags
  [no] Defina este parâmetro como zero.

Return Value

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero.

A função falhará se iDevNum é maior que o maior índice dispositivo.

Remarks

A consulta exibir todos os dispositivos no sistema, chamar essa função em um executar um loop, começando com iDevNum Defina como 0 e o incremento iDevNum até que a função falhar.

Para selecionar todos os dispositivos exibir no área de trabalho, use somente os dispositivos exibir que possuem o sinalizador DISPLAY_DEVICE_ATTACHED_TO_DESKTOP na DISPLAY_DEVICE estrutura.

Para informações sobre o dispositivo exibir, chamar get EnumDisplayDevices Com lpDevice Definir como NULL. Por exemplo DISPLAY_DEVICE.DeviceString Contém o nome dispositivo.

Para obter informações sobre um monitor exibir, chamar primeiro EnumDisplayDevices Com lpDevice Definir como NULL. O nome dispositivo é retornado no lpDisplayDevice. Use esse valor em lpDevice e defina iDevNum Para zero em um segundo chamar para EnumDisplayDevices. DISPLAY_DEVICE.DeviceString Retorna o nome monitor posteriormente.

EnumDisplayDevices pressupõe que haja apenas um monitor por dispositivo exibir. Ele não é possível obter informações para múltiplo monitores anexado a um dispositivo exibir único. Esse comportamento difere área de trabalho Windows-Based plataformas.

Requirements

Header	windows.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.2 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

ChangeDisplaySettingsEx
CreateDC
DEVMODE
DISPLAY_DEVICE
EnumDisplaySettings
GDI Functions