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

  • Статья

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

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

Задает значение яркости монитора. Увеличение значения яркости делает дисплей на мониторе ярче, а уменьшение делает его более светлым.

Синтаксис

_BOOL SetMonitorBrightness(
  [in] HANDLE hMonitor,
  [in] DWORD  dwNewBrightness
);

Параметры

[in] hMonitor

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

[in] dwNewBrightness

Значение яркости. Чтобы получить минимальное и максимальное значения яркости монитора, вызовите Метод GetMonitorBrightness.

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

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

Комментарии

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

Эта функция возвращает около 50 миллисекундах.

Параметр яркости является параметром непрерывного монитора. Дополнительные сведения см. в разделе Использование функций конфигурации монитора High-Level.

Требования

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

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

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