Windows平台用WMI查询GPU使用率最可靠，推荐使用Win32_PerfFormattedData_GPUPerformanceCounters_GPUAdapterEngine类的PercentBusy字段（Win10 2004+），需COM多线程初始化、ROOTWMI命名空间，并确保WMI服务运行及性能计数器已启用。
Windows平台用WMI查询GPU使用率最可靠
Windows没有公开的、跨厂商的GPU占用率API，DXGI和Direct3D本身不暴露实时GPU引擎负载。WMI（Windows Management Instrumentation）是目前最稳定、无需驱动SDK、兼容NVIDIA/AMD/Intel通用显卡的方式——前提是系统启用了WMI服务且有管理员权限运行。
关键类是 Win32_PerfFormattedData_GPUPerformanceCounters_GPUAdapterMemory（旧版）或更推荐的 Win32_PerfFormattedData_GPUPerformanceCounters_GPUAdapterEngine（Win10 2004+），后者直接提供 PercentBusy 字段。
- 必须用
CoInitializeEx(nullptr, COINIT_MULTITHREADED)初始化COM - 查询需指定命名空间：
ROOT\CIMV2或更准确的ROOT\WMI（部分GPU计数器在此） - 若返回空结果，大概率是WMI性能计数器未启用：运行
lodctr /R重载计数器，或检查services.msc中Windows Management Instrumentation是否启动 - NVIDIA驱动较新时，
PercentBusy可能始终为0——这是已知WMI兼容性问题，此时需降级到Win32_PerfFormattedData_GPUPerformanceCounters_GPUAdapterMemory并计算UsedMemory / TotalMemory作为间接指标
Linux下用sysfs读取NVIDIA GPU利用率
Linux原生不提供统一GPU占用接口，NVIDIA驱动通过 /proc/driver/nvidia/gpus/*/information 和 /proc/driver/nvidia/gpus/*/utilization 暴露基础数据；AMD GPU（ROCm）走 /sys/class/kfd/kfd/topology/nodes/*/properties，但无直接%值；Intel核显则依赖 intel_gpu_top 工具或 /sys/class/drm/card*/gt_boost_freq_mhz 等间接参数。
对NVIDIA最简方案是读取 /proc/driver/nvidia/gpus/0000:01:00.0/utilization（路径中的PCI地址需先枚举）：
在OpenClaw上部署你的首席AI助理贾维斯（JARVIS）。针对Dell Pro Max GB10（NVIDIA DGX Spark）边缘设备优化。用于设置和配置贾维斯。
立即学习“C++免费学习笔记（深入）”；
cat /proc/driver/nvidia/gpus/0000:01:00.0/utilization Gpu : 42 % Memory : 18 %
- 必须以root权限读取，普通用户会报
Permission denied - PCI地址格式为
0000:BB:DD.F，需先从/proc/driver/nvidia/gpus/目录遍历获取有效子目录名 - 该文件每秒更新一次，频繁读取无性能压力，但不可用于毫秒级监控
- 注意：当GPU处于P0以外的电源状态（如P8）时，
Gpu行可能消失或返回N/A，需做容错判断
跨平台方案只能靠第三方库或折中处理
不存在标准C++跨平台GPU占用率API。试图用OpenGL/Vulkan扩展（如VK_EXT_physical_device_diagnostics_config）获取负载，实际只在极少数调试驱动中启用，生产环境不可用。
-
nvml.h（NVIDIA Management Library）是最实用的方案，但仅限NVIDIA，且需链接nvidia-ml-py或 C API 的libnvidia-ml.so/nvidia-ml.dll，不自带于系统 - AMD提供
ADL SDK，但已停止维护，新版RDNA显卡支持极差；ROCm的hipRuntime.h不暴露利用率 - 折中做法：Windows用WMI，Linux按GPU厂商分支处理（
std::string vendor = get_gpu_vendor()），并默认fallback到显存占用率或温度（/sys/class/hwmon/hwmon*/temp1_input）作为代理指标 - 所有方案都要求程序有足够权限——无权限时返回0或-1是常态，不是代码写错了
常见错误：误用DirectX API查GPU占用
很多开发者尝试用 IDXGIAdapter::GetDesc 或 ID3D12Device::GetNodeMask 获取GPU信息，但这些函数只返回硬件描述、显存大小、设备类型等静态字段，完全不包含任何实时占用率数据。
-
IDXGIAdapter3::QueryVideoMemoryInfo返回的是显存预算/当前使用量，不是GPU核心计算负载 -
D3D12_QUERY_HEAP_TYPE_TIMESTAMP可测单个命令列表耗时，但无法换算成“当前GPU占用率”，因为缺乏全局时间基准 - 试图轮询
Present调用间隔来估算——这实际反映的是帧率或垂直同步状态，与GPU引擎忙闲无关 - 错误日志如
DXGI_ERROR_NOT_FOUND或返回全0的GPUFrequency字段，基本可判定你调用了错误的接口
/proc/driver/nvidia路径不可见，而ROCm需要显式加载kfd内核模块。这些不是代码问题，但会让整套逻辑静默失效。 
