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