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

  • Статья

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

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

Извлекает минимальные, максимальные и текущие параметры яркости монитора.

Синтаксис

_BOOL GetMonitorBrightness(
  [in]  HANDLE  hMonitor,
  [out] LPDWORD pdwMinimumBrightness,
  [out] LPDWORD pdwCurrentBrightness,
  [out] LPDWORD pdwMaximumBrightness
);

Параметры

[in] hMonitor

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

[out] pdwMinimumBrightness

Получает минимальную яркость монитора.

[out] pdwCurrentBrightness

Получает текущую яркость монитора.

[out] pdwMaximumBrightness

Получает максимальную яркость монитора.

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

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

Комментарии

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

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

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

Требования

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

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

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