最直接方式是调用WinAPI的EnumDisplaySettings函数获取dmDisplayFrequency字段，需传ENUM_CURRENT_SETTINGS、初始化DEVMODE并校验返回值；Linux推荐xrandr解析，macOS用CGDisplayModeGetRefreshRate；注意VRR下数值仅为标称值而非实时刷新率。
Windows平台用EnumDisplaySettings获取刷新率
在Windows上，最直接的方式是调用WinAPI的EnumDisplaySettings函数，它能读取当前活动显示设备的显式设置，包括dmDisplayFrequency字段。注意：这个值依赖于当前分辨率和刷新率组合是否被系统实际应用——如果用户在显示设置里选了“60Hz”，但显卡驱动没真正提交该模式，返回值可能仍是旧值。
实操要点：
- 必须传入
ENUM_CURRENT_SETTINGS（即-1）作为第二个参数，否则可能读到默认或历史配置 -
DEVMODE结构体需初始化为0，并正确设置dmSize字段（用sizeof(DEVMODE)），否则EnumDisplaySettings会失败并返回0 - 返回值为
FALSE时，需用GetLastError()检查是否为ERROR_NO_DISPLAY_MODES等错误，而不是直接认为“无刷新率” - 多显示器场景下，需用
EnumDisplayDevices枚举每个DeviceName，再对每个设备调用EnumDisplaySettings
Linux上通过xrandr解析输出或使用drm接口
Linux没有统一API，主流做法分两类：用户态靠xrandr命令解析，内核态靠DRM ioctl。前者简单但依赖X11/Wayland兼容层；后者精确但需root权限且代码复杂。
推荐优先尝试xrandr方案：
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 执行
xrandr --verbose，查找当前激活输出（如HDMI-1）下的Monitor physical size之后的Current mode:行，再匹配对应h:... v:...中带+HSync +VSync且标有*（当前激活）的那条，其末尾数字即为Hz值 - 若程序不能起shell进程，可用
libdrm读取/dev/dri/renderD128，调用drmModeGetConnector→drmModeGetEncoder→drmModeGetCrtc，再从crtc->mode.vrefresh取值——但注意Wayland会禁用直接DRM访问，且不同GPU驱动（Intel/AMD/NVIDIA）对vrefresh填充策略不一致，有些返回0 - 不要信任
xrandr -q输出里的“*”标记——某些老旧显卡驱动在缩放模式下会错误标记多个模式为当前
macOS需用CGDisplayModeRef和CGDisplayModeGetRefreshRate
macOS从10.15开始，CGDisplayCopyAllDisplayModes已弃用，应改用CGDisplayCopyDisplayMode获取当前模式，再调用CGDisplayModeGetRefreshRate。该函数返回double类型值，但实际精度有限：多数Mac只报告60.0或120.0，ProMotion机型才可能返回更细粒度（如96.0、102.0）。
关键细节：
- 必须传入主屏的
CGDirectDisplayID（用CGMainDisplayID()获取），传错ID会导致返回0.0 - 某些外接显示器（尤其USB-C转HDMI适配器）在macOS下无法正确报告刷新率，
CGDisplayModeGetRefreshRate恒返回0.0，此时只能fallback到CGDisplayModeGetWidth/CGDisplayModeGetHeight查分辨率，再结合硬件文档推测 - 不要用
CGDisplayModeGetIOFlags判断是否支持高刷——该标志位仅表示“硬件能力”，不代表当前启用状态
跨平台封装时别忽略“逻辑刷新率”和“物理刷新率”的差异
很多开发者误以为拿到的数值就是屏幕真实刷新频率，其实不然。比如Windows开启“可变刷新率”（FreeSync/G-Sync）后，dmDisplayFrequency仍返回标称最大值（如144），而实际帧间隔由GPU动态控制；macOS的ProMotion屏在滚动时可能降频至10Hz，但CGDisplayModeGetRefreshRate始终返回最高值。
这意味着：
- 做垂直同步渲染时，不能只依赖这个值计算帧时间——需结合
VSync信号或vkGetPhysicalDeviceSurfaceCapabilitiesKHR（Vulkan）等运行时反馈 - 性能监控工具若仅显示“60Hz”，可能掩盖掉VRR带来的帧时间波动，导致误判卡顿
- Unity/Unreal等引擎内部通常绕过系统API，直接查询GPU驱动暴露的刷新率寄存器，比C++层读到的更接近真实
真正难的不是读出那个数字，而是理解它代表什么、在什么条件下失效、以及何时该换别的指标来代替它。
