Функция GetMonitorInfoA (winuser.h)

Статья
11/20/2024

Функция GetMonitorInfo извлекает сведения о мониторе отображения.

Синтаксис

BOOL GetMonitorInfoA(
  [in]  HMONITOR      hMonitor,
  [out] LPMONITORINFO lpmi
);

Параметры

[in] hMonitor

Дескриптор для монитора, интересующего вас.

[out] lpmi

Указатель на структуру MONITORINFO или MONITORINFOEX, которая получает сведения о указанном мониторе отображения.

Перед вызовом функции GetMonitorInfo необходимо задать элемент структуры (MONITORINFOINFO) или sizeof(MONITORINFOEX). Это позволяет функции определять тип структуры, передаваемой в нее.

Структура MONITORINFOEX представляет собой супермножество структуры MONITORINFO. Он имеет один дополнительный элемент: строка, содержащая имя монитора отображения. Большинство приложений не используют отображаемое имя монитора и поэтому могут сохранять некоторые байты с помощью структуры MONITORINFO.

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

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю.

Замечания

Заметка

Заголовок winuser.h определяет GetMonitorInfo как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll
набор API	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (представлено в Windows 10 версии 10.0.14393)

См. также

MONITORINFO

MONITORINFOEX

функции нескольких мониторов отображения

обзор нескольких мониторов отображения

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