GetMonitorCapabilities, fonction (highlevelmonitorconfigurationapi.h)

2025-05-21

Avertissement

Les fonctions de configuration du moniteur physique fonctionnent à l’aide de la norme MCCS (VESA Monitor Control Command Set) sur une interface I²C. 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 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 vers 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. Voir les remarques.

[out] pdwSupportedColorTemperatures

Reçoit un OR au niveau du bit des indicateurs de température de couleur. Voir les remarques.

Valeur retournée

Si la fonction aboutit, la valeur renvoyée est VRAI. Si la fonction échoue, la valeur renvoyée est FAUX. Pour obtenir des informations d’erreur étendues, 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 les fonctions de configuration de moniteur de haut niveau 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 de surveillance utilisés par les fonctions de configuration de moniteur de haut niveau. Pour plus d’informations, consultez la section Notes de 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 4 000 kelvins (K) température de couleur.
MC_SUPPORTED_COLOR_TEMPERATURE_5000K	Le moniteur prend en charge 5 000 K de température de couleur.
MC_SUPPORTED_COLOR_TEMPERATURE_6500K	Le moniteur prend en charge 6 500 K de température de couleur.
MC_SUPPORTED_COLOR_TEMPERATURE_7500K	Le moniteur prend en charge 7 500 K de température de couleur.
MC_SUPPORTED_COLOR_TEMPERATURE_8200K	Le moniteur prend en charge 8 200 K de température de couleur.
MC_SUPPORTED_COLOR_TEMPERATURE_9300K	Le moniteur prend en charge 9 300 K de température de couleur.
MC_SUPPORTED_COLOR_TEMPERATURE_10000K	Le moniteur prend en charge 10 000 K de température de couleur.
MC_SUPPORTED_COLOR_TEMPERATURE_11500K	Le moniteur prend en charge 11 500 K de température de couleur.

Spécifications

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

Voir aussi

surveiller les fonctions de configuration

Partager via