Fonction SetMonitorColorTemperature (highlevelmonitorconfigurationapi.h)

Avertissement

Les fonctions de configuration du moniteur physique fonctionnent à l’aide de la norme VESA Monitor Control Command Set (MCCS) sur une interface I²C. De nombreux moniteurs n’implémentent pas entièrement cette norme ; votre utilisation de ces commandes peut entraîner un comportement de surveillance non défini. Nous vous déconseillons d’utiliser ces fonctions pour les moniteurs arbitraires sans valider physiquement qu’elles fonctionnent comme prévu.

Définit la température de couleur d’un moniteur.

Syntaxe

_BOOL SetMonitorColorTemperature(
  [in] HANDLE               hMonitor,
  [in] MC_COLOR_TEMPERATURE ctCurrentColorTemperature
);

Paramètres

[in] hMonitor

Gérer sur un moniteur physique. Pour obtenir le handle du moniteur, appelez GetPhysicalMonitorsFromHMONITOR ou GetPhysicalMonitorsFromIDirect3DDevice9.

[in] ctCurrentColorTemperature

Température de couleur, spécifiée en tant que membre de l’énumération MC_COLOR_TEMPERATURE .

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE. Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Si cette fonction est prise en charge, la fonction GetMonitorCapabilities retourne l’indicateur MC_CAPS_COLOR_TEMPERATURE. La fonction GetMonitorCapabilities retourne également la plage de températures de couleur prise en charge par le moniteur. Le paramètre ctCurrentColorTemperature doit correspondre à l’une de ces valeurs.

La modification de la température de couleur modifie le point blanc du moniteur. Il peut également modifier le lecteur actuel et gagner des paramètres. Pour obtenir le nouveau lecteur et obtenir les paramètres, appelez Respectivement GetMonitorRedGreenOrBlueDrive et GetMonitorRedGreenOrBlueGain.

Cette fonction prend de 50 à 90 millisecondes pour retourner.

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	highlevelmonitorconfigurationapi.h
Bibliothèque	Dxva2.lib
DLL	Dxva2.dll

Voir aussi

Surveiller les fonctions de configuration