getMonitorInfoA 函数 (winuser.h)

  • 项目

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 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.14393 中引入的 ext-ms-win-ntuser-sysparams-ext-l1-1-1 ()

另请参阅

MONITORINFO

MONITORINFOEX

多个显示监视器函数

多个显示监视器概述