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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in] hMonitor

Дескриптор интересующего монитора.

[out] lpmi

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

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

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

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

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

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

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

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	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

Функции мониторов с несколькими дисплеями

Обзор мониторов с несколькими дисплеями