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

Статья
08/24/2023

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

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

Извлекает значение диска монитора красного, зеленого или синего цвета.

Синтаксис

_BOOL GetMonitorRedGreenOrBlueDrive(
  [in]  HANDLE        hMonitor,
  [in]  MC_DRIVE_TYPE dtDriveType,
  [out] LPDWORD       pdwMinimumDrive,
  [out] LPDWORD       pdwCurrentDrive,
  [out] LPDWORD       pdwMaximumDrive
);

Параметры

[in] hMonitor

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

[in] dtDriveType

Элемент перечисления MC_DRIVE_TYPE , указывающий, следует ли получить значение диска : красный, зеленый или синий.

[out] pdwMinimumDrive

Получает минимальное значение диска красного, зеленого или синего цвета.

[out] pdwCurrentDrive

Получает текущее красное, зеленое или синее значение диска.

[out] pdwMaximumDrive

Получает максимальное значение диска красного, зеленого или синего цвета.

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

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

Параметры диска обычно используются для настройки точки белого цвета монитора. Уровень диска и черного цвета — это разные имена для одного и того же параметра монитора. Если эта функция поддерживается, функция GetMonitorCapabilities возвращает флаг MC_CAPS_RED_GREEN_BLUE_DRIVE.

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

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

Требования


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

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

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