Condividi tramite


struttura DISPLAY_DEVICEA (wingdi.h)

La struttura DISPLAY_DEVICE riceve informazioni sul dispositivo di visualizzazione specificato dal parametro iDevNum della funzione EnumDisplayDevices.

Sintassi

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;

Membri

cb

Dimensioni, in byte, della struttura DISPLAY_DEVICE. Questa operazione deve essere inizializzata prima di chiamare EnumDisplayDevices.

DeviceName[32]

Matrice di caratteri che identificano il nome del dispositivo. Si tratta del dispositivo adattatore o del dispositivo di monitoraggio.

DeviceString[128]

Matrice di caratteri contenente la stringa del contesto di dispositivo. Si tratta di una descrizione della scheda di visualizzazione o del monitor di visualizzazione.

StateFlags

Flag di stato del dispositivo. Può essere qualsiasi combinazione ragionevole di quanto segue.

Valore Significato
DISPLAY_DEVICE_ACTIVE DISPLAY_DEVICE_ACTIVE specifica se un monitor viene visualizzato come "attivato" dalla rispettiva vista GDI. Windows Vista: EnumDisplayDevices enumererà solo i monitoraggi che possono essere presentati come "attiva".
DISPLAY_DEVICE_MIRRORING_DRIVER Rappresenta uno pseudo dispositivo utilizzato per eseguire il mirroring del disegno dell'applicazione per la comunicazione remota o altri scopi. Un pseudo monitor invisibile è associato a questo dispositivo. Ad esempio, NetMeeting lo usa. Si noti che GetSystemMetrics (SM_MONITORS) solo gli account per i monitor di visualizzazione visibili.
DISPLAY_DEVICE_MODESPRUNED Il dispositivo ha più modalità di visualizzazione rispetto al supporto dei dispositivi di output.
DISPLAY_DEVICE_PRIMARY_DEVICE Il desktop primario si trova nel dispositivo. Per un sistema con una singola scheda di visualizzazione, questa opzione è sempre impostata. Per un sistema con più schede di visualizzazione, può essere impostato un solo dispositivo.
DISPLAY_DEVICE_REMOVABLE Il dispositivo è rimovibile; non può essere la visualizzazione primaria.
DISPLAY_DEVICE_VGA_COMPATIBLE Il dispositivo è compatibile con VGA.

DeviceID[128]

Non utilizzato.

DeviceKey[128]

Riservato.

Osservazioni

I quattro membri stringa vengono impostati in base ai parametri passati a EnumDisplayDevices. Se il parametro lpDevice è NULL, DISPLAY_DEVICE viene compilato con informazioni sulle schede di visualizzazione. Se si tratta di un nome di dispositivo valido, viene compilato con informazioni sui monitor per tale dispositivo.

Nota

L'intestazione wingdi.h definisce DISPLAY_DEVICE come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
intestazione wingdi.h (include Windows.h)

Vedere anche

strutture del contesto di dispositivo

Panoramica dei contesti di dispositivo

EnumDisplayDevices

GetSystemMetrics