Fonction EnumDisplaySettingsExA (winuser.h)
La fonction EnumDisplaySettingsEx récupère des informations sur l’un des modes graphiques d’un périphérique d’affichage. Pour récupérer des informations pour tous les modes graphiques d’un périphérique d’affichage, effectuez une série d’appels à cette fonction.
Cette fonction diffère de EnumDisplaySettings en ce qu’il existe un paramètre dwFlags .
BOOL EnumDisplaySettingsExA(
[in] LPCSTR lpszDeviceName,
[in] DWORD iModeNum,
[out] DEVMODEA *lpDevMode,
[in] DWORD dwFlags
);
[in] lpszDeviceName
Pointeur vers une chaîne terminée par null qui spécifie le périphérique d’affichage sur le mode graphique auquel la fonction obtiendra des informations.
Ce paramètre est NULL ou un DISPLAY_DEVICE. DeviceName retourné par EnumDisplayDevices. Une valeur NULL spécifie l’appareil d’affichage actuel sur l’ordinateur sur lequel le thread appelant s’exécute.
[in] iModeNum
Indique le type d’informations à récupérer. Cette valeur peut être un index en mode graphique ou l’une des valeurs suivantes.
Les index du mode graphique commencent à zéro. Pour obtenir des informations sur tous les modes graphiques d’un appareil d’affichage, effectuez une série d’appels à EnumDisplaySettingsEx, comme suit : définissez iModeNum sur zéro pour le premier appel et incrémentez iModeNum d’un pour chaque appel suivant. Continuez à appeler la fonction jusqu’à ce que la valeur de retour soit égale à zéro.
Lorsque vous appelez EnumDisplaySettingsEx avec iModeNum défini sur zéro, le système d’exploitation initialise et met en cache les informations sur l’appareil d’affichage. Lorsque vous appelez EnumDisplaySettingsEx avec iModeNum défini sur une valeur différente de zéro, la fonction retourne les informations mises en cache la dernière fois que la fonction a été appelée avec iModeNum défini sur zéro.
[out] lpDevMode
Pointeur vers une structure DEVMODE dans laquelle la fonction stocke des informations sur le mode graphique spécifié. Avant d’appeler EnumDisplaySettingsEx, définissez le membre dmSize sur sizeof (DEVMODE) et définissez le membre dmDriverExtra pour indiquer la taille, en octets, de l’espace supplémentaire disponible pour recevoir les données du pilote privé.
La fonction EnumDisplaySettingsEx remplit le membre dmFields du lpDevMode et un ou plusieurs autres membres de la structure DEVMODE . Pour déterminer quels membres ont été définis par l’appel à EnumDisplaySettingsEx, inspectez le masque de bits dmFields . Voici quelques-uns des champs généralement remplis par cette fonction :
- dmBitsPerPel
- dmPelsWidth
- dmPelsHeight
- dmDisplayFlags
- dmDisplayFrequency
- dmPosition
- dmDisplayOrientation
[in] dwFlags
Ce paramètre peut être la valeur suivante.
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
La fonction échoue si iModeNum est supérieur à l’index du dernier mode graphique de l’appareil d’affichage. Comme indiqué dans la description du paramètre iModeNum , vous pouvez utiliser ce comportement pour énumérer tous les modes graphiques d’un périphérique d’affichage.
Cette API ne participe pas à la virtualisation DPI. La sortie donnée est toujours en termes de pixels physiques et n’est pas liée au contexte appelant.Notes
L’en-tête winuser.h définit EnumDisplaySettingsEx 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.
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | winuser.h (inclure Windows.h) |
Bibliothèque | User32.lib |
DLL | User32.dll |
Ensemble d’API | ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introduit dans Windows 10, version 10.0.14393) |
Fonctions de contexte d’appareil