Функция GetVCPFeatureAndVCPFeatureReply (lowlevelmonitorconfigurationapi.h)

Статья
08/24/2023

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

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

Извлекает текущее значение, максимальное значение и тип кода виртуального панель управления (VCP) для монитора.

Синтаксис

_BOOL GetVCPFeatureAndVCPFeatureReply(
  [in]  HANDLE             hMonitor,
  [in]  BYTE               bVCPCode,
  [out] LPMC_VCP_CODE_TYPE pvct,
  [out] LPDWORD            pdwCurrentValue,
  [out] LPDWORD            pdwMaximumValue
);

Параметры

[in] hMonitor

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

[in] bVCPCode

Код VCP для запроса. Коды VCP включают стандарт НАБОРА команд управления монитора VESA (MCCS) версий 1.0 и 2.0. Этот параметр должен указывать непрерывный или непрестанный VCP или код конкретного поставщика. Это не должен быть код элемента управления таблицей.

[out] pvct

Получает тип кода VCP в качестве члена перечисления MC_VCP_CODE_TYPE . Этот параметр может принимать значение NULL.

[out] pdwCurrentValue

Получает текущее значение кода VCP. Этот параметр может принимать значение NULL.

[out] pdwMaximumValue

Если bVCPCode указывает непрерывный код VCP, этот параметр получает максимальное значение кода VCP. Если bVCPCode указывает не непрерывный код VCP, значение, полученное в этом параметре, не определено. Этот параметр может принимать значение NULL.

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

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

Эта функция соответствует команде Get VCP Feature & VCP Feature Reply (Получить функцию VCP Feature Reply) из стандарта интерфейса команд канала отображения данных (DDC/CI). С этой функцией можно использовать коды VCP для конкретных поставщиков.

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

Требования

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

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

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