Функция GetMonitorCapabilities (highlevelmonitorconfigurationapi.h)

Предупреждение

Функции конфигурации физического монитора работают с помощью стандартного набора команд управления VESA (MCCS) через интерфейс I²C. Многие мониторы не полностью реализуют этот стандарт; Поэтому использование этих команд может привести к неопределенному поведению монитора. Мы не рекомендуем использовать эти функции для произвольных мониторов без физический проверки того, что они работают должным образом.

Извлекает возможности конфигурации монитора. Вызовите эту функцию, чтобы узнать, какие функции конфигурации монитора высокого уровня поддерживаются монитором.

Синтаксис

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

Параметры

[in] hMonitor

Обработка физического монитора. Чтобы получить дескриптор монитора, вызовите GetPhysicalMonitorsFromHMONITOR или GetPhysicalMonitorsFromIDirect3DDevice9.

[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	Монитор поддерживает 11500 K цветовой температуры.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
Заголовок	highlevelmonitorconfigurationapi.h
Библиотека	Dxva2.lib
Библиотека dll	Dxva2.dll

См. также

мониторинг функций конфигурации