Поделиться через


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

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

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

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

Синтаксис

_BOOL SetMonitorRedGreenOrBlueDrive(
  [in] HANDLE        hMonitor,
  [in] MC_DRIVE_TYPE dtDriveType,
  [in] DWORD         dwNewDrive
);

Параметры

[in] hMonitor

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

[in] dtDriveType

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

[in] dwNewDrive

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

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

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

Комментарии

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

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

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

Изменение параметров диска может изменить цветовую температуру. Чтобы получить новую цветовую температуру, вызовите Метод GetMonitorColorTemperature.

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

Требования

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

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

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