SetMonitorRedGreenOrBlueDrive, fonction (highlevelmonitorconfigurationapi.h)

Article
08/24/2023

Avertissement

Les fonctions de configuration du moniteur physique fonctionnent à l’aide de la norme VESA Monitor Control Command Set (MCCS) sur une interface^I2C. De nombreux moniteurs n’implémentent pas entièrement cette norme ; Ainsi, 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 vérifier physiquement qu’ils fonctionnent comme prévu.

Définit la valeur de lecteur rouge, vert ou bleu d’un moniteur.

Syntaxe

_BOOL SetMonitorRedGreenOrBlueDrive(
  [in] HANDLE        hMonitor,
  [in] MC_DRIVE_TYPE dtDriveType,
  [in] DWORD         dwNewDrive
);

Paramètres

[in] hMonitor

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

[in] dtDriveType

Membre du MC_DRIVE_TYPE énumération, spécifiant s’il faut définir la valeur de lecteur rouge, vert ou bleu.

[in] dwNewDrive

Valeur de lecteur rouge, vert ou bleu. Pour obtenir les valeurs de lecteur minimales et maximales du moniteur, appelez GetMonitorRedGreenOrBlueDrive.

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

Les paramètres de lecteur sont généralement utilisés pour ajuster le point blanc du moniteur. Lecteur et niveau noir sont des noms différents pour le même paramètre de moniteur.

Si cette fonction est prise en charge, la fonction GetMonitorCapabilities retourne l’indicateur MC_CAPS_RED_GREEN_BLUE_DRIVE.

Le retour de cette fonction prend environ 50 millisecondes.

La modification des paramètres du lecteur peut modifier la température de couleur. Pour obtenir la nouvelle température de couleur, appelez GetMonitorColorTemperature.

Les paramètres de lecteur sont des paramètres de surveillance continue. Pour plus d’informations, consultez Utilisation des fonctions de configuration High-Level Monitor.

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

Partager via