structure DISPLAY_DEVICEA (wingdi.h)

La structure DISPLAY_DEVICE reçoit des informations sur le périphérique d’affichage spécifié par le paramètre iDevNum de la fonction EnumDisplayDevices .

Syntaxe

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;

Membres

cb

Taille, en octets, de la structure DISPLAY_DEVICE . Cela doit être initialisé avant d’appeler EnumDisplayDevices.

DeviceName[32]

Tableau de caractères identifiant le nom de l’appareil. Il s’agit du périphérique de l’adaptateur ou du périphérique de surveillance.

DeviceString[128]

Tableau de caractères contenant la chaîne de contexte de l’appareil. Il s’agit d’une description de l’adaptateur d’affichage ou du moniteur d’affichage.

StateFlags

Indicateurs d’état de l’appareil. Il peut s’agir d’une combinaison raisonnable des éléments suivants.

Valeur	Signification
DISPLAY_DEVICE_ACTIVE	DISPLAY_DEVICE_ACTIVE spécifie si un moniteur est présenté comme étant « activé » par la vue GDI correspondante. Windows Vista : EnumDisplayDevices énumère uniquement les moniteurs qui peuvent être présentés comme étant « activés ».
DISPLAY_DEVICE_MIRRORING_DRIVER	Représente un pseudo-appareil utilisé pour miroir dessin d’application à des fins de communication à distance ou à d’autres fins. Un pseudo moniteur invisible est associé à cet appareil. Par exemple, NetMeeting l’utilise. Notez que GetSystemMetrics (SM_MONITORS) prend uniquement en compte les moniteurs d’affichage visibles.
DISPLAY_DEVICE_MODESPRUNED	L’appareil a plus de modes d’affichage que ses appareils de sortie prennent en charge.
DISPLAY_DEVICE_PRIMARY_DEVICE	Le bureau principal se trouve sur l’appareil. Pour un système avec une seule carte d’affichage, cette valeur est toujours définie. Pour un système avec plusieurs cartes d’affichage, un seul appareil peut avoir cet ensemble.
DISPLAY_DEVICE_REMOVABLE	L’appareil est amovible ; il ne peut pas s’agir de l’affichage principal.
DISPLAY_DEVICE_VGA_COMPATIBLE	L’appareil est compatible VGA.

DeviceID[128]

Non utilisé.

DeviceKey[128]

Réservé.

Remarques

Les quatre membres de chaîne sont définis en fonction des paramètres passés à EnumDisplayDevices. Si l’analyseur lpDevice a la valeur NULL, DISPLAY_DEVICE est renseigné avec des informations sur la ou les cartes d’affichage. S’il s’agit d’un nom d’appareil valide, il est renseigné avec des informations sur les moniteurs de cet appareil.

Notes

L’en-tête wingdi.h définit DISPLAY_DEVICE comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	wingdi.h (inclure Windows.h)

Voir aussi

Structures de contexte d’appareil

Vue d’ensemble des contextes d’appareil

EnumDisplayDevices

GetSystemMetrics