Функция 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

См. также раздел

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