最直接可靠的方式是调用EnumDisplayMonitors(NULL, NULL, 回调, lParam),统计HMONITOR数量;它反映GDI管理的逻辑显示器数,含禁用但保留设置的显示器,需传NULL hdc以避免遗漏主屏外设备。

Windows平台用EnumDisplayMonitors枚举显示器数量
最直接可靠的方式是调用Windows API的EnumDisplayMonitors,它能真实反映系统当前连接并被识别的显示器(包括启用/禁用状态)。注意:不是查显卡接口或EDID,而是查GDI实际管理的显示设备。
关键点:
-
EnumDisplayMonitors会统计所有“逻辑显示器”(即HMONITOR),哪怕某显示器被系统设为“断开但保留设置”,只要在显示设置里存在,就会被计入 - 必须传入
NULL作为第一个参数( hdc ),否则只枚举与指定DC关联的显示器,容易漏掉主屏以外的设备 - 回调函数里每收到一个
HMONITOR就++计数器,最终总数 ≥ 2 即表示有第二显示器
示例片段:
int monitorCount = 0;
EnumDisplayMonitors(NULL, NULL, [](HMONITOR, HDC, LPRECT, LPARAM) -> BOOL {
++*(int*)lParam;
return TRUE;
}, (LPARAM)&monitorCount);
// monitorCount == 1 → 只有主屏;≥2 → 至少连了第二个显示器
macOS用NSScreen获取活跃屏幕列表
macOS下不能依赖显示器物理连接状态,而要看NSScreen返回的screens数组——它只包含当前“活跃且有坐标空间”的屏幕(即已启用、分辨率非零、未被镜像关闭的显示器)。
立即学习“C++免费学习笔记(深入)”;
常见误区:
-
[NSScreen screens]返回的是NSArray *,长度就是当前可用屏幕数,但不包含被用户手动关闭(“镜像关闭”或“未启用”)的显示器 - 如果用户开启了“镜像显示”,
screens数组长度仍为1,即使物理上连了两台显示器 - 想检测“是否至少连了两个物理显示器”,需结合
CGDisplayIsBuiltin()和CGGetOnlineDisplayList(),但后者需要CGDirectDisplayID,权限更重
日常判断是否可做多屏布局,用[NSScreen screens].count > 1即可;若严格要物理连接数,得走Core Graphics底层API。
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
Linux上读/sys/class/drm或调X11 Xinerama
Linux没有统一API,方案取决于显示后端。Wayland尚无稳定跨 compositor 的查询方式,主流做法仍是面向X11或内核接口。
两种实用路径:
- 查
/sys/class/drm/*/status:每个card*-*目录对应一个输出(如card0-HDMI-A-1),读其status文件,内容为connected即表示该接口有设备接入(注意:不等于已启用,仅物理连接) - 用X11的
XineramaQueryScreens:返回的是当前X server认可的“屏幕区域”数组,长度即为逻辑屏幕数(类似Windows的HMONITOR),但要求X server启用了Xinerama扩展(现代多数发行版默认开启)
推荐优先用X11方式,因为更贴近应用层实际可用的显示能力;若程序不依赖X11(如systemd service或headless环境),再 fallback 到/sys/class/drm解析。
跨平台封装要注意isSecondaryDisplayAvailable的语义歧义
很多项目写个isSecondaryDisplayAvailable()函数,但不同平台返回值含义其实不一致:
- Windows:
true表示至少有两个HMONITOR(含禁用但保留设置的) - macOS:
true表示至少有两个NSScreen(即用户已启用多屏模式) - Linux X11:
true表示Xinerama报告多个屏幕(取决于xorg.conf配置)
这意味着同一台机器,在macOS上可能返回false(用户关了副屏),而Windows返回true(副屏只是禁用)。业务逻辑里若据此自动弹窗到副屏,务必先检查该屏幕是否visible或frame有效,不能只看数量。
真正难的不是“有没有第二显示器”,而是“此刻能不能安全把窗口放过去”。

















