Функция GetMonitorCapabilities (highlevelmonitorconfigurationapi.h)
Предупреждение
Функции конфигурации физического монитора работают с использованием стандарта НАБОРА команд управления монитором VESA (MCCS) через интерфейс I2C. Многие мониторы не полностью реализуют этот стандарт; поэтому использование этих команд может привести к неопределенному поведению монитора. Мы не рекомендуем использовать эти функции для произвольных мониторов без физической проверки их работы.
Извлекает возможности конфигурации монитора. Вызовите эту функцию, чтобы узнать, какие высокоуровневые функции конфигурации монитора поддерживаются монитором.
Синтаксис
_BOOL GetMonitorCapabilities(
[in] HANDLE hMonitor,
[out] LPDWORD pdwMonitorCapabilities,
[out] LPDWORD pdwSupportedColorTemperatures
);
Параметры
[in] hMonitor
Обработка на физическом мониторе. Чтобы получить дескриптор монитора, вызовите Метод GetPhysicalMonitorsFromHMONITOR или GetPhysicalMonitorsFromIDirect3Device9.
[out] pdwMonitorCapabilities
Получает побитовое ИЛИ флагов возможностей. См. заметки.
[out] pdwSupportedColorTemperatures
Получает побитовое ИЛИ флагов цветовой температуры. См. заметки.
Возвращаемое значение
Если функция выполняется успешно, возвращается значение TRUE. Если функция завершается сбоем, возвращается значение FALSE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Функция завершается сбоем, если монитор не поддерживает DDC/CI.
Комментарии
Флаги возможностей, возвращаемые в pdwMonitorCapabilities , указывают, какие высокоуровневые функции конфигурации монитора поддерживаются монитором. Они также определяют поведение определенных функций. Определены следующие флаги возможностей.
| Значение | Описание |
|---|---|
| MC_CAPS_BRIGHTNESS | Монитор поддерживает функции GetMonitorBrightness и SetMonitorBrightness . |
| MC_CAPS_COLOR_TEMPERATURE | Монитор поддерживает функции GetMonitorColorTemperature и SetMonitorColorTemperature . |
| MC_CAPS_CONTRAST | Монитор поддерживает функции GetMonitorContrast и SetMonitorContrast . |
| MC_CAPS_DEGAUSS | Монитор поддерживает функцию DegaussMonitor . |
| MC_CAPS_DISPLAY_AREA_POSITION | Монитор поддерживает функции GetMonitorDisplayAreaPosition и SetMonitorDisplayAreaPosition . |
| MC_CAPS_DISPLAY_AREA_SIZE | Монитор поддерживает функции GetMonitorDisplayAreaSize и SetMonitorDisplayAreaSize . |
| MC_CAPS_MONITOR_TECHNOLOGY_TYPE | Монитор поддерживает функцию GetMonitorTechnologyType . |
| MC_CAPS_NONE | Монитор не поддерживает параметры монитора. |
| MC_CAPS_RED_GREEN_BLUE_DRIVE | Монитор поддерживает функции GetMonitorRedGreenOrBlueDrive и SetMonitorRedGreenOrBlueDrive . |
| MC_CAPS_RED_GREEN_BLUE_GAIN | Монитор поддерживает функции GetMonitorRedGreenOrBlueGain и SetMonitorRedGreenOrBlueGain . |
| MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS | Монитор поддерживает функцию RestoreMonitorFactoryColorDefaults . |
| MC_CAPS_RESTORE_FACTORY_DEFAULTS | Монитор поддерживает функцию RestoreMonitorFactoryDefaults . |
| MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS | Если этот флаг присутствует, вызов функции RestoreMonitorFactoryDefaults включает все параметры монитора, используемые высокоуровневыми функциями конфигурации монитора. Дополнительные сведения см. в разделе Примечания статьи RestoreMonitorFactoryDefaults. |
Флаги цветовой температуры, возвращаемые в pdwSupportedColorTemperatures , указывают, какие цветовые температуры поддерживаются монитором. Определены следующие флаги цветовой температуры.
| Значение | Описание |
|---|---|
| MC_SUPPORTED_COLOR_TEMPERATURE_NONE | Цветовая температура не поддерживается. |
| MC_SUPPORTED_COLOR_TEMPERATURE_4000K | Монитор поддерживает цветовую температуру 4000 кельвинов (K). |
| MC_SUPPORTED_COLOR_TEMPERATURE_5000K | Монитор поддерживает цветовую температуру 5000 K. |
| MC_SUPPORTED_COLOR_TEMPERATURE_6500K | Монитор поддерживает цветовую температуру 6500 K. |
| MC_SUPPORTED_COLOR_TEMPERATURE_7500K | Монитор поддерживает цветовую температуру 7500 K. |
| MC_SUPPORTED_COLOR_TEMPERATURE_8200K | Монитор поддерживает цветовую температуру 8200 K. |
| MC_SUPPORTED_COLOR_TEMPERATURE_9300K | Монитор поддерживает цветовую температуру 9300 K. |
| MC_SUPPORTED_COLOR_TEMPERATURE_10000K | Монитор поддерживает цветовую температуру 10 000 K. |
| MC_SUPPORTED_COLOR_TEMPERATURE_11500K | Монитор поддерживает цветовую температуру 11 500 K. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | highlevelmonitorconfigurationapi.h |
| Библиотека | Dxva2.lib |
| DLL | Dxva2.dll |