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

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

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

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

Синтаксис

_BOOL RestoreMonitorFactoryDefaults(
  [in] HANDLE hMonitor
);

Параметры

[in] hMonitor

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

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

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

Комментарии

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

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

Для возврата этой функции требуется около 5 секунд.

Если GetMonitorCapabilities возвращает флаг MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS, эта функция также включает все параметры монитора, поддерживаемые высокоуровневые функции. Иногда приложение может отключить определенные параметры, вызвав низкоуровневые функции. Пользователь также может отключить определенные параметры, настроив параметры на физической панели управления монитора. В этом случае параметр можно повторно включить только на панели управления или путем вызова RestoreMonitorFactoryDefaults. Отключить какие-либо параметры с помощью высокоуровневых функций невозможно.

Требования

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

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

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

RestoreMonitorFactoryColorDefaults