C++如何获取系统的显示器刷新率参数-C++-PHP中文网

windows用enumdisplaysettings获取当前生效刷新率（dmdisplayfrequency），需正确设备名和清零devmode；macos用cgdisplaycopydisplaymode+cgdisplaymodegetfloatvalue读取单显示器模式值；x11需xrandr或randr扩展解析当前crtc模式；sdl_getdesktopdisplaymode不可靠，跨平台应优先选用原生api或qt的qscreen::refreshrate()。

c++如何获取系统的显示器刷新率参数

Windows平台用 `EnumDisplaySettings` 获取当前显示器刷新率

Windows下最直接的方式是调用GDI API的 EnumDisplaySettings，它能读取当前活动显示设备的显卡驱动上报的刷新率（即 dmDisplayFrequency 字段）。注意：这不是“理论最大值”，而是当前生效的设置值。

常见错误是传入错误的设备名 —— 必须用 ENUM_CURRENT_SETTINGS 或先调用 EnumDisplayDevices 获取真实设备名（如 "\\.\DISPLAY1"），硬编码 "DISPLAY1" 会失败。

调用前确保 DEVMODE 结构体清零，并设置 dmSize = sizeof(DEVMODE)，否则返回 FALSE
刷新率单位是 Hz，dmDisplayFrequency 为 0 表示驱动未提供该值（常见于虚拟机或某些核显）
多显示器场景下，需对每个 DISPLAY<i>n</i> 设备分别枚举，不能默认只查主屏

macOS上通过 `CGDisplayModeRef` 读取 `kCGDisplayRefreshRate`

macOS不暴露全局“系统刷新率”概念，每个显示器有独立模式，需用 Core Graphics 框架获取当前激活模式的刷新率。关键函数是 CGDisplayCopyDisplayMode + CGDisplayModeGetFloatValue。

容易忽略的是：必须传入真实的 display ID（如 CGMainDisplayID() 或从 CGGetActiveDisplayList 获取），传 0 会崩溃；且 kCGDisplayRefreshRate 在部分外接显示器或缩放模式下可能返回 0.0 或 60.0（即使实际是 120Hz）。

返回值类型是 CFNumberRef，需用 CGDisplayModeGetFloatValue 转换，直接 cast 会出错
Retina 显示器启用“缩放”时，系统可能报告逻辑刷新率而非物理面板值（例如 MacBook Pro 16" 120Hz 屏在默认缩放下仍报 60.0）
需要链接 -framework CoreGraphics，否则链接失败

Linux X11环境下解析 `xrandr` 输出或使用 RandR 扩展

X11 没有统一API返回“当前刷新率”，可靠方式是调用 xrandr --verbose 解析 stdout，或用 Xlib 的 RandR 扩展（XRRGetScreenResources + XRRGetOutputInfo + XRRGetCrtcInfo）查当前 CRTC 的 mode。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

直接读 /sys/class/graphics/fb0/videomode 或 /proc/fb 不可靠 —— 它们反映 framebuffer 层配置，和实际 GPU 输出刷新率常不一致（尤其启用了 compositor 或多显卡时）。

xrandr 解析需匹配 “*” 标记的当前模式行，再提取括号内数值（如 1920x1080 60.00*+）
RandR 方式需注意：mode id 是整数，要从 XRRGetScreenResources 返回的 modes 数组中索引，不能直接用 crtc->mode 值
Wayland 环境下 xrandr 可能不可用，需走 wl_output 接口（但 C++ 绑定复杂，通常建议用 xdpyinfo 或桌面环境 D-Bus 接口）

跨平台封装时为什么不能只依赖 `SDL_GetDesktopDisplayMode`

SDL_GetDesktopDisplayMode 看似方便，但它返回的是“桌面默认模式”，不是当前实际刷新率 —— 尤其在 Windows 上，若用户手动设置了 144Hz 但桌面模式仍是 60Hz，它就返回 60；macOS 上它甚至可能返回 0（SDL 2.26+ 已修复部分情况，但仍有 fallback 行为）。

真正需要精确帧同步（如游戏引擎 vsync 控制、视频播放器时基校准）时，必须走原生 API。SDL 更适合快速原型，而非生产级刷新率感知。