Partager via


Fonction RestoreMonitorFactoryColorDefaults (highlevelmonitorconfigurationapi.h)

Avertissement

Les fonctions de configuration du moniteur physique fonctionnent à l’aide de la norme VESA Monitor Control Command Set (MCCS) sur une interfaceI2C. 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.

Restaure les paramètres de couleur d’un moniteur à leurs paramètres d’usine par défaut.

Syntaxe

_BOOL RestoreMonitorFactoryColorDefaults(
  [in] HANDLE hMonitor
);

Paramètres

[in] hMonitor

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

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.

Remarques

Cette fonction peut modifier la valeur actuelle de la luminosité, du contraste, de la température de couleur, du lecteur et du gain du moniteur. La valeur actuelle de chaque paramètre est remplacée par sa valeur de fabrique par défaut. Les paramètres par défaut dépendent du fabricant. Cette fonction peut également modifier la plage de valeurs prises en charge pour chacun de ces paramètres. La fonction n’active aucun paramètre d’analyse désactivé.

Si cette fonction est prise en charge, la fonction GetMonitorCapabilities retourne l’indicateur MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS. Le retour de cette fonction prend environ 5 secondes.

Cette fonction peut réinitialiser les paramètres d’analyse qui ne sont pas accessibles via les fonctions de configuration de moniteur de haut niveau. La question de savoir si cela se produit dépend du modèle spécifique du moniteur.

Les paramètres suivants ne sont pas affectés par cette fonction :

  • Taille de la zone d’affichage
  • Position de la zone d’affichage
  • Indicateurs de fonctionnalités

Configuration requise

Condition requise Valeur
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

RestoreMonitorFactoryDefaults