Section courante

A propos

Section administrative du site

ChangeDisplaySettingsExA

 user32.dll Change l'affichage d'ajustement étendues
Windows NT 4+, 2000, XP, 2003

Syntaxe

LONG ChangeDisplaySettingsExA(LPCTSTR lpszDeviceName, DEVMODE *lpDevMode, HWND hwnd, DWORD dwflags, LPVOID lParam);

Paramètres

Nom Description
lpszDeviceName Ce paramètre permet d'indiquer un pointeur vers une chaine de caractères ASCIZ spécifiant le périphérique d'affichage pour mode graphique devant être changé.
lpDevMode Ce paramètre pointe sur un champ permettant d'indiquer le mode vidéo souhaitez:
Champs Description
dmBitsPerPel Ce champ permet d'indiquer le nombre de bits par pixel
dmPelsWidth Ce champ permet d'indiquer la largeur de l'écran en pixel
dmPelsHeight Ce champ permet d'indiquer la hauteur de l'écran en pixel
dmDisplayFlags Ce champ permet d'indiquer l'un ou les drapeaux du mode:
Constante Valeur Description
DM_BITSPERPEL 0x00040000 Cette constante permet d'indiquer de tenir compte de la valeur du champs «dmBitsPerPel»
DM_PELSWIDTH 0x00080000 Cette constante permet d'indiquer de tenir compte de la valeur du champs «dmPelsWidth»
DM_PELSHEIGHT 0x00100000 Cette constante permet d'indiquer de tenir compte de la valeur du champs «dmPelsHeight»
DM_DISPLAYFLAGS 0x00200000 Cette constante permet d'indiquer de tenir compte de la valeur du champs «dmDisplayFlags»
DM_DISPLAYFREQENCY 0x00400000 Cette constante permet d'indiquer de tenir compte de la valeur du champs «dmDisplayFrequency»
dmDisplayFrequency Ce champ permet d'indiquer la fréquence du mode
hwnd Ce paramètre permet d'indiquer le Handle de la fenêtre. Dois toujours avoir la valeur NULL.
dwflags Ce paramètre permet d'indiquer le mode de changement graphique:
Constante Valeur Description
  0x00000000 Cette valeur permet d'indiquer un changement dynamique
CDS_UPDATEREGISTRY 0x00000001 Cette valeur permet d'indiquer un changement dynamique avec une mise-à-jour de la base de registres
CDS_TEST 0x00000002 Cette valeur permet d'indiquer que le système d'exploitation effectuer une vérification si le mode vidéo est supporté correctement.
CDS_FULLSCREEN 0x00000004 Cette valeur permet d'indiquer qu'il faut passer au mode pleine écran. Ce mode est généralement temporaire, et si vous changez pour un autre bureau, ce mode n'est pas réinitialiser sous Windows NT/2000 et XP.
CDS_GLOBAL 0x00000008 Cette valeur permet d'ajuster la région de données global pour qu'elle affecte tous les utilisateurs de la machine.
CDS_SET_PRIMARY 0x00000010 Cette valeur permet d'effectuer les changements sur périphérique primaire.
CDS_NORESET 0x10000000 Cette valeur permet de sauvegarder la modification dans la base de registres sans pour autant changer le mode vidéo immédiatement.
CDS_RESET 0x40000000 Cette valeur permet d'effectuer les changements, même si la requête d'ajustement correspond à ajustement courant.
CDS_VIDEOPARAMETERS   Cette valeur permet d'indiquer qu'il faut utilisé les paramètres de la structure VIDEOPARAMETERS laquelle est contenu dans le paramètre lParam.
lParam Ce paramètre vaut NULL s'il n'est pas utilisé, sinon, il faut mettre CDS_VIDEOPARAMETERS dans le paramètre dwFlags et le faire pointer sur une structure «VIDEOPARAMETERS» :
Champs Type de données Description
guid GUID Ce champ permet d'indiquer le GUID de la structure. Soit la valeur 02C62061-1097-11d1-920F-00A024DF156E. Le pilote d'affichage vidéo vérifie le GUID au début de la structure de données.
dwOffset ULONG Ce champ permet d'indiquer le déplacement. Vaut toujours 0.
dwCommand ULONG Ce champ permet d'indiquer les valeurs a demander ou fixer indiquant les autres membres de cette structure :
Constante Description
VP_COMMAND_GET Cette constante permet d'indiquer de demander la compatibilité vidéo courante. Si la compatibilité n'est pas supporté, le champ dwFlags vaut 0.
VP_COMMAND_SET Cette constante permet d'indiquer de fixer les paramètres vidéos.
dwFlags ULONG Ce champ permet d'indiquer les champs contenant des données valides :
Constante Description
VP_FLAGS_TV_MODE Cette constante permet d'indiquer que les champs dwMode (pour VP_COMMAND_GET et VP_COMMAND_SET) et dwAvailableModes (pour VP_COMMAND_GET) sont valides.
VP_FLAGS_TV_STANDARD Cette constante permet d'indiquer que les champs dwTVStandard (pour VP_COMMAND_GET et VP_COMMAND_SET) et dwAvailableTVStandard (pour VP_COMMAND_GET) sont valides.
VP_FLAGS_FLICKER Cette constante permet d'indiquer que le champ dwFlickerFilter (pour VP_COMMAND_GET et VP_COMMAND_SET) est valide.
VP_FLAGS_OVERSCAN Cette constante permet d'indiquer que les champs dwOverScanX (pour VP_COMMAND_GET et VP_COMMAND_SET) et dwOverScanY (pour VP_COMMAND_GET et VP_COMMAND_SET) sont valides.
VP_FLAGS_MAX_UNSCALED Cette constante permet d'indiquer que les champs dwMaxUnscaledX (pour VP_COMMAND_GET) et dwMaxUnscaledY (pour VP_COMMAND_GET) sont valides.
VP_FLAGS_POSITION Cette constante permet d'indiquer que les champs dwPositionX (pour VP_COMMAND_GET et VP_COMMAND_SET) et dwPositionY (pour VP_COMMAND_GET et VP_COMMAND_SET) sont valides.
VP_FLAGS_BRIGHTNESS Cette constante permet d'indiquer que le champ dwBrightness (pour VP_COMMAND_GET et VP_COMMAND_SET) est valide.
VP_FLAGS_CONTRAST Cette constante permet d'indiquer que le champ dwContrast (pour VP_COMMAND_GET et VP_COMMAND_SET) est valide.
VP_FLAGS_COPYPROTECT Cette constante permet d'indiquer que les champs dwCPType (pour VP_COMMAND_GET et VP_COMMAND_SET), dwCPCommand (pour VP_COMMAND_SET), dwCPStandard (pour VP_COMMAND_GET), dwCPKey (pour VP_COMMAND_SET), bCP_APSTriggerBits (pour VP_COMMAND_GET et VP_COMMAND_SET), et bOEMCopyProtection (pour VP_COMMAND_GET et VP_COMMAND_SET) sont valides.
dwMode ULONG Ce champ permet d'indiquer le mode de rejouage :
Constante Description
VP_MODE_WIN_GRAPHICS Cette constante permet d'indiquer de décrire un ensemble d'affichage d'ajustement étant optimal pour l'affichage Windows.
VP_MODE_TV_PLAYBACK Cette constante permet d'indiquer de décrire un ensemble d'affichage pour le jouage du vidéo.
dwTVStandard ULONG Ce champ permet d'indiquer le mode de télévision standard :
Constante Description
VP_TV_STANDARD_NTSC_433 Cette constante permet d'indiquer un signal de téléviseur standard NTSC 433.
VP_TV_STANDARD_NTSC_M Cette constante permet d'indiquer un signal de téléviseur standard NTSC M.
VP_TV_STANDARD_NTSC_M_J Cette constante permet d'indiquer un signal de téléviseur standard NTSC M/J.
VP_TV_STANDARD_PAL_60 Cette constante permet d'indiquer un signal de téléviseur standard PAL 60.
VP_TV_STANDARD_PAL_B Cette constante permet d'indiquer un signal de téléviseur standard PAL B.
VP_TV_STANDARD_PAL_D Cette constante permet d'indiquer un signal de téléviseur standard PAL D.
VP_TV_STANDARD_PAL_G Cette constante permet d'indiquer un signal de téléviseur standard PAL G.
VP_TV_STANDARD_PAL_H Cette constante permet d'indiquer un signal de téléviseur standard PAL H.
VP_TV_STANDARD_PAL_I Cette constante permet d'indiquer un signal de téléviseur standard PAL I.
VP_TV_STANDARD_PAL_M Cette constante permet d'indiquer un signal de téléviseur standard PAL M.
VP_TV_STANDARD_PAL_N Cette constante permet d'indiquer un signal de téléviseur standard PAL N.
VP_TV_STANDARD_SECAM_B Cette constante permet d'indiquer un signal de téléviseur standard SECAM B.
VP_TV_STANDARD_SECAM_D Cette constante permet d'indiquer un signal de téléviseur standard SECAM D.
VP_TV_STANDARD_SECAM_G Cette constante permet d'indiquer un signal de téléviseur standard SECAM G.
VP_TV_STANDARD_SECAM_H Cette constante permet d'indiquer un signal de téléviseur standard SECAM H.
VP_TV_STANDARD_SECAM_K Cette constante permet d'indiquer un signal de téléviseur standard SECAM K.
VP_TV_STANDARD_SECAM_K1 Cette constante permet d'indiquer un signal de téléviseur standard SECAM K1.
VP_TV_STANDARD_SECAM_L Cette constante permet d'indiquer un signal de téléviseur standard SECAM L.
VP_TV_STANDARD_SECAM_L1 Cette constante permet d'indiquer un signal de téléviseur standard SECAM L1.
VP_TV_STANDARD_WIN_VGA Cette constante permet d'indiquer un signal de téléviseur standard de fenêtre VGA.
dwAvailableModes ULONG Ce champ permet d'indiquer les modes disponibles.
dwAvailableTVStandard ULONG Ce champ permet d'indiquer la disponibilité de la télévision standard.
dwFlickerFilter ULONG Ce champ permet de réduire le vacillement provoquer par le matériel.
dwOverScanX ULONG Ce champ permet d'indiquer la quantité de balayage de ligne dans la direction horizontal.
dwOverScanY ULONG Ce champ permet d'indiquer la quantité de balayage de ligne dans la direction vertical.
dwMaxUnscaledX ULONG Ce champ permet d'indiquer la résolution horizontal maximal, en pixels, étant supporté par le vidéo sans appliquer d'échelle.
dwMaxUnscaledY ULONG Ce champ permet d'indiquer la résolution vertical maximal, en pixels, étant supporté par le vidéo sans appliquer d'échelle.
dwPositionX ULONG Ce champ permet d'indiquer l'ajustement horizontal du centre de l'image.
dwPositionY ULONG Ce champ permet d'indiquer l'ajustement vertical du centre de l'image.
dwBrightness ULONG Ce champ permet d'ajuster le déplacement du périphérique de contexte du signal vidéo augmentant la brillance du téléviseur. La valeur de ce champ est un pourcentage situé entre 0 et 100.
dwContrast ULONG Ce champ permet d'ajuster le déplacement du périphérique de contexte du signal vidéo augmentant la constrate du téléviseur. La valeur de ce champ est un pourcentage situé entre 0 et 100.
dwCPType ULONG Ce champ permet d'indiquer le type de protection contre la copie :
Constante Description
VP_CP_TYPE_APS_TRIGGER Cette constante permet d'indiquer que seul les bits de déclencheur DVD sont disponibles.
VP_CP_TYPE_MACROVISION Cette constante permet d'indiquer que toutes les données Macrovision sont disponibles.
dwCPCommand ULONG Ce champ permet d'envoyer une commande de protection contre la copie :
Constante Description
VP_CP_CMD_ACTIVATE Cette constante permet d'indiquer d'activer la protection contre la copie.
VP_CP_CMD_CHANGE Cette constante permet d'indiquer de changer la protection contre la copie.
VP_CP_CMD_DEACTIVATE Cette constante permet d'indiquer la désactivation de la protection contre la copie.
dwCPStandard ULONG Ce champ permet de spécifié télévision standard pour les types de protection contre la copie étant disponible.
dwCPKey ULONG Ce champ permet d'indiquer la clef de protection contre la copie si le champ dwCPCommand est fixé à VP_CP_CMD_ACTIVATE.
bCP_APSTriggerBits ULONG Ce champ permet d'indiquer le drapeau de bits de déclencheur de DVD APS :
Valeur Description
0 Cette valeur permet d'indiquer qu'il n'y a pas de protection contre la copie.
1, 2 ou 3 Ces valeurs permettent d'indiquer une méthode de protection analogique Macrovision utilisateur.
bOEMCopyProtection UCHAR [256] Ce champ permet d'indiquer les données de protection contre la copie OEM spécifié. Le nombre maximum de caractères est 256 caractères.

Retour

Valeur Description
DISP_CHANGE_SUCCESSFUL Cette valeur permet d'indiquer que le changement d'ajustement a été un succès.
DISP_CHANGE_BADDUALVIEW Cette valeur permet d'indiquer que le changement d'ajustement n'a pas réussis à cause que le système n'a pas la capacité du DualView.
DISP_CHANGE_BADFLAGS Cette valeur permet d'indiquer que l'ensemble des drapeaux n'est pas valide pour passer dans le mode.
DISP_CHANGE_BADMODE Cette valeur permet d'indiquer que le mode graphique n'est pas supporté.
DISP_CHANGE_BADPARAM Cette valeur permet d'indiquer que les paramètres passés sont invalides.
DISP_CHANGE_FAILED Cette valeur permet d'indiquer que le pilote d'affichage a échoué pour le mode graphique spécifié.
DISP_CHANGE_NOTUPDATED Cette valeur permet d'indiquer qu'il n'est pas possible d'écrire les ajustements dans le registre.
DISP_CHANGE_RESTART Cette valeur permet d'indiquer que le changement demandé nécessite un redémarrage de l'ordinateur pour que le mode graphique fonctionne correctement.

Description

Cette fonction permet de modifier les paramètres du mode d'affichage graphique pour le périphérique d'affichage spécifié.

Voir également

Articles - Les géants de l'informatique - Microsoft

Dernière mise à jour : Dimanche, le 6 décembre 2015