Fonction GetMonitorCapabilities (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 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.

Récupère les fonctionnalités de configuration d’un moniteur. Appelez cette fonction pour savoir quelles fonctions de configuration de moniteur de haut niveau sont prises en charge par le moniteur.

Syntaxe

_BOOL GetMonitorCapabilities(
  [in]  HANDLE  hMonitor,
  [out] LPDWORD pdwMonitorCapabilities,
  [out] LPDWORD pdwSupportedColorTemperatures
);

Paramètres

[in] hMonitor

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

[out] pdwMonitorCapabilities

Reçoit un OR au niveau du bit des indicateurs de fonctionnalités. Consultez la section Notes.

[out] pdwSupportedColorTemperatures

Reçoit un OR au niveau du bit des indicateurs de température de couleur. Consultez la section Notes.

Valeur de retour

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.

La fonction échoue si le moniteur ne prend pas en charge DDC/CI.

Remarques

Les indicateurs de fonctionnalités retournés dans pdwMonitorCapabilities spécifient quelles fonctions de configuration de moniteur de haut niveau sont prises en charge par le moniteur. Ils spécifient également le comportement de certaines fonctions. Les indicateurs de fonctionnalités suivants sont définis.

Valeur	Description
MC_CAPS_BRIGHTNESS	Le moniteur prend en charge les fonctions GetMonitorBrightness et SetMonitorBrightness .
MC_CAPS_COLOR_TEMPERATURE	Le moniteur prend en charge les fonctions GetMonitorColorTemperature et SetMonitorColorTemperature .
MC_CAPS_CONTRAST	Le moniteur prend en charge les fonctions GetMonitorContrast et SetMonitorContrast .
MC_CAPS_DEGAUSS	Le moniteur prend en charge la fonction DegaussMonitor .
MC_CAPS_DISPLAY_AREA_POSITION	Le moniteur prend en charge les fonctions GetMonitorDisplayAreaPosition et SetMonitorDisplayAreaPosition .
MC_CAPS_DISPLAY_AREA_SIZE	Le moniteur prend en charge les fonctions GetMonitorDisplayAreaSize et SetMonitorDisplayAreaSize .
MC_CAPS_MONITOR_TECHNOLOGY_TYPE	Le moniteur prend en charge la fonction GetMonitorTechnologyType .
MC_CAPS_NONE	Le moniteur ne prend pas en charge les paramètres d’analyse.
MC_CAPS_RED_GREEN_BLUE_DRIVE	Le moniteur prend en charge les fonctions GetMonitorRedGreenOrBlueDrive et SetMonitorRedGreenOrBlueDrive .
MC_CAPS_RED_GREEN_BLUE_GAIN	Le moniteur prend en charge les fonctions GetMonitorRedGreenOrBlueGain et SetMonitorRedGreenOrBlueGain .
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS	Le moniteur prend en charge la fonction RestoreMonitorFactoryColorDefaults .
MC_CAPS_RESTORE_FACTORY_DEFAULTS	Le moniteur prend en charge la fonction RestoreMonitorFactoryDefaults .
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS	Si cet indicateur est présent, l’appel de la fonction RestoreMonitorFactoryDefaults active tous les paramètres d’analyse utilisés par les fonctions de configuration de moniteur de haut niveau. Pour plus d’informations, consultez la section Remarques dans RestoreMonitorFactoryDefaults.

Les indicateurs de température de couleur retournés dans pdwSupportedColorTemperatures spécifient les températures de couleur prises en charge par le moniteur. Les indicateurs de température de couleur suivants sont définis.

Valeur	Description
MC_SUPPORTED_COLOR_TEMPERATURE_NONE	Aucune température de couleur n’est prise en charge.
MC_SUPPORTED_COLOR_TEMPERATURE_4000K	Le moniteur prend en charge une température de couleur de 4 000 kelvins (K).
MC_SUPPORTED_COLOR_TEMPERATURE_5000K	Le moniteur prend en charge une température de couleur de 5 000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_6500K	Le moniteur prend en charge une température de couleur de 6 500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_7500K	Le moniteur prend en charge une température de couleur de 7 500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_8200K	Le moniteur prend en charge une température de couleur de 8 200 K.
MC_SUPPORTED_COLOR_TEMPERATURE_9300K	Le moniteur prend en charge une température de couleur de 9 300 K.
MC_SUPPORTED_COLOR_TEMPERATURE_10000K	Le moniteur prend en charge une température de couleur de 10 000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_11500K	Le moniteur prend en charge une température de couleur de 11 500 K.

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

Partager via