Share via

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

  • Статья

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

Функции конфигурации физического монитора работают с использованием стандарта НАБОРА команд управления монитором VESA (MCCS) через интерфейс I2C. Многие мониторы не полностью реализуют этот стандарт; поэтому использование этих команд может привести к неопределенному поведению монитора. Мы не рекомендуем использовать эти функции для произвольных мониторов без физической проверки того, что они работают должным образом.

Восстанавливает параметры цвета монитора до заводских значений по умолчанию.

Синтаксис

_BOOL RestoreMonitorFactoryColorDefaults(
  [in] HANDLE hMonitor
);

Параметры

[in] hMonitor

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

Возвращаемое значение

Если функция выполнена успешно, возвращается значение TRUE. Если функция завершается сбоем, возвращается значение FALSE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Эта функция потенциально изменяет текущее значение яркости, контрастности, цветовой температуры, диска и усиления монитора. Текущее значение каждого параметра изменяется на заводские значения по умолчанию. Параметры по умолчанию зависят от производителя. Эта функция также может изменять диапазон поддерживаемых значений для каждого из этих параметров. Функция не включает отключенные параметры монитора.

Если эта функция поддерживается, функция GetMonitorCapabilities возвращает флаг MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS. Для возврата этой функции требуется около 5 секунд.

Эта функция может сбрасывать параметры монитора, недоступные с помощью высокоуровневых функций конфигурации монитора. Происходит ли это, зависит от конкретной модели монитора.

Эта функция не влияет на следующие параметры:

  • Размер области отображения
  • Положение области отображения
  • Флаги возможностей

Требования

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

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

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

RestoreMonitorFactoryDefaults