Windows用EnumDisplaySettings传ENUM_CURRENT_SETTINGS获取当前Hz值；macOS用CGDisplayModeGetRefreshRate读double型值；Linux需xrandr--verbose解析，三者均不提供统计图，须自行定时采样绘制。
Windows平台用 EnumDisplaySettings 获取当前显示器刷新率
Windows下最直接的方式是调用GDI API的 EnumDisplaySettings，它能读取当前活动显示器的实时设置（注意：不是EDID硬编码值，而是系统实际应用的模式）。关键点在于必须传入 ENUM_CURRENT_SETTINGS 标志，否则可能返回历史配置或默认值。
-
EnumDisplaySettings第二个参数必须为ENUM_CURRENT_SETTINGS，传0或其他索引容易拿到非当前激活的模式 -
DEVMODE.dmDisplayFrequency字段才是实际刷新率（单位Hz），不是dmBitsPerPel或dmPelsWidth - 需先调用
EnumDisplayDevices获取主显示器名称（如\\.\DISPLAY1），不能硬编码设备名，多屏环境下名称不固定 - 该API返回的是整数Hz值（如60、144），不提供小数精度——Windows图形栈本身不暴露如143.89这样的浮点值
macOS用 CGDisplayModeGetRefreshRate 读取Core Graphics刷新率
macOS上必须通过 CGDisplayModeRef 获取当前活跃显示模式，再调用 CGDisplayModeGetRefreshRate。直接查 CGDisplayGetMainDisplay 不够，因为用户可能启用了HiDPI缩放或外接显示器，需明确绑定到当前主屏的活跃模式。
- 先用
CGMainDisplayID()获取主屏ID，再用CGDisplayCopyDisplayMode(displayID)拿到当前模式句柄 -
CGDisplayModeGetRefreshRate返回double类型，常见值如60.0、120.0，但部分Pro Display XDR或MacBook Pro高刷屏会返回100.0、120.0等非标准值 - 该值受“自动切换刷新率”开关影响（系统偏好设置→显示器→刷新率），关闭时固定为60Hz，开启后才可能动态变化
- 无法获取历史帧率波动统计图——Core Graphics不提供采样接口，需自行定时轮询并记录
Linux上从 /sys/class/graphics/fb0/videomode 和 xrandr 双路验证
Linux没有统一API，必须组合使用内核接口和X11/Wayland工具。Framebuffer路径只反映底层驱动初始化值，而 xrandr --verbose 输出才体现当前X Server实际应用的模式，二者常不一致。
- 读
/sys/class/graphics/fb0/videomode得到类似U:1920x1080p-60的字符串，解析出60即标称刷新率，但该值可能被显卡驱动忽略 - 真正可靠的命令是
xrandr --verbose | grep -A 1 "connected" | grep "hertz"，输出如60.00*+中的数字（*表示当前激活，+表示首选） - Wayland环境下
xrandr失效，需用weston-info或调用xdg-output协议（需Wayland客户端权限），普通C++程序无权直接访问 - 刷新率动态切换（如Adaptive Sync）在Linux上基本不可见——内核DRM层不向用户态暴露实时帧间隔数据
生成“实时统计图”需要自己实现采样+绘图，系统不提供
所有操作系统都不提供“刷新率统计图”这种高级视图。所谓“详细参数统计图”必须由你手动实现：定时采集刷新率（每秒1–10次）、记录时间戳和数值、再用第三方库（如ImGui、SFML或Qt Charts）绘制折线图。别指望 EnumDisplaySettings 或 CGDisplayModeGetRefreshRate 返回带时间序列的数据结构。
立即学习“C++免费学习笔记（深入）”；
- Windows/macOS/Linux三端都要自己开定时器（
std::chrono::steady_clock+std::this_thread::sleep_for），不能依赖系统回调 - 采样间隔不宜过短（1s），错过VRR动态切换过程
- 注意刷新率本身是离散值（60/75/120/144等），所谓“实时波动”其实是VSync信号抖动，需用高精度计时器测帧间隔再反推，而非查API
- 最终图表的横轴是本地时间，纵轴是Hz值，但Y轴范围建议固定为40–240Hz，避免因单次异常值拉伸整个视图
真正的难点不在读取，而在理解“刷新率”在不同抽象层的含义差异：EDID里是显示器能力，驱动里是协商结果，合成器里是最终输出节奏——三者可能同时存在且不一致。你拿到的永远只是其中一层快照。
