structure DISPLAY_DEVICEA (wingdi.h)
La structure DISPLAY_DEVICE reçoit des informations sur l’appareil 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 de l’appareil adaptateur ou de l’appareil moniteur.
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 mettre en miroir le dessin d’application à distance ou à d’autres fins. Un pseudo-moniteur invisible est associé à cet appareil. Par exemple, NetMeeting l’utilise. Notez que GetSystemMetrics (SM_MONITORS) compte uniquement pour 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 carte d’affichage unique, il est toujours défini. 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 AVEC LE MODÈLE. |
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'lpDevice param est NULL, DISPLAY_DEVICE est renseigné avec des informations sur les adaptateurs d’affichage. S’il s’agit d’un nom d’appareil valide, il est renseigné avec des informations sur le ou les moniteurs de cet appareil.
Note
L’en-tête wingdi.h définit DISPLAY_DEVICE en tant qu’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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| d’en-tête | wingdi.h (include Windows.h) |
Voir aussi
structures de contexte d’appareil