Share via

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

  • Статья

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

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

Задает горизонтальное или вертикальное положение области отображения монитора.

Увеличение горизонтального положения перемещает область отображения в правую часть экрана; уменьшается, область отображения перемещается влево. Увеличение вертикальной позиции перемещает область отображения в верхнюю часть экрана; уменьшается, область отображения перемещается в нижнюю часть.

Синтаксис

_BOOL SetMonitorDisplayAreaPosition(
  [in] HANDLE           hMonitor,
  [in] MC_POSITION_TYPE ptPositionType,
  [in] DWORD            dwNewPosition
);

Параметры

[in] hMonitor

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

[in] ptPositionType

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

[in] dwNewPosition

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

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

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

Комментарии

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

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

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

Требования

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

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

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