NWinfo如何读取GPU数据?NVAPI、ADL2与IGCL三大GPU API实战揭秘
NWinfo如何读取GPU数据?NVAPI、ADL2与IGCL三大GPU API实战揭秘
NWinfo是一款运行在Windows上的开源硬件信息工具,它不依赖WMI,而是通过厂商官方API直接从显卡驱动中获取GPU数据。本文将带你揭秘NWinfo如何调用NVAPI(NVIDIA)、ADL2(AMD)与IGCL(Intel)三大GPU API,读取显卡名称、显存、温度、功耗、频率与风扇转速等实时数据,并理解其统一的抽象层设计。
为什么需要三套不同的API?
不同厂商的显卡驱动各自提供独立的监控接口:
| 厂商 | API | 底层DLL | 主要用途 |
|---|---|---|---|
| NVIDIA | NVAPI | nvapi64.dll / nvapi.dll | 显存、温度、功耗、频率、风扇 |
| AMD | ADL2 | atiadlxx.dll | 传感器数据、Overdrive、PMLog |
| Intel | IGCL(Control API) | ControlLib.dll | 功耗遥测、显存模块、PCIe状态 |
这三套API的函数命名、数据结构、版本机制完全不同,如果直接调用,维护成本极高。因此NWinfo在 libnw/gpu/ 目录下为每家实现了一个独立驱动模块,再用一个统一数据结构把所有数据"翻译"成同一套字段。
统一抽象层:NWLIB_GPU_DEV
所有GPU驱动最终都往同一个结构体里填数据,定义在 gpu.h:
typedef struct _NWLIB_GPU_DEV
{
char Name[MAX_GPU_STR]; // 显卡名称
uint32_t VendorId, DeviceId; // PCI ID
uint64_t TotalMemory; // 显存总量
uint64_t FreeMemory; // 显存空闲
double Temperature; // 温度
double Power; // 功耗 (W)
double Frequency; // 核心频率 (MHz)
uint64_t FanSpeed; // 风扇转速 (RPM)
// ...
} NWLIB_GPU_DEV;
每个厂商驱动则实现一个统一的"驱动表" NWLIB_GPU_DRV(见 gpu.h),只含三个钩子:
Init—— 加载DLL、枚举设备GetInfo—— 每轮刷新时读取传感器Free—— 释放资源
在 gpu.c 中,NWL_InitGpu() 依次注册 Intel、AMD、NVIDIA、DXCore、D3D 五个后端;任何一个初始化失败(比如你没装NVIDIA驱动),就自动跳过,不影响其他后端继续工作。这种"插件式"设计正是NWinfo能同时支持独显+核显混插机器的关键。
NVAPI实战:NVIDIA数据读取链路 🟢
NVIDIA模块位于 nvidia_gpu.c,其调用链如下:
1. 动态加载而非静态链接。 nvapi.c 通过 LoadLibraryW(L"nvapi64.dll") 加载DLL,再用 nvapi_QueryInterface + 哈希GUID逐个解析函数指针。这样即使驱动更新导致导出变化,NWinfo也能优雅降级。
2. 枚举设备并过滤。 nv_gpu_init() 调用 NvAPI_Initialize() 和 NvAPI_EnumPhysicalGPUs(),再检查 VendorId 是否为 NVIDIA,把无效设备标记为不可用(nvidia_gpu.c)。
3. 版本回退是NVAPI编程的日常。 NVIDIA的结构体几乎都带 version 字段,新版本驱动可能拒绝旧版本。NWinfo的做法是"从新到旧逐级重试",例如读取显存时先试 NV_GPU_MEMORY_INFO_EX_VER,失败再回退到 v3、v2(见 get_legacy_mem_info);读电压时更是构造了 VoltRails → Pstates20 v3/v2/v1 → PstatesL 的五级回退链(get_uv_voltage);温度也尝试 ThermalSettings v2、v1 乃至按位轮询 NVAPI_GPU_GetThermalSensors(get_temperature)。
4. 每轮刷新的数据流。 nv_gpu_get() 遍历所有GPU:NvAPI_GPU_GetMemoryInfoEx 取显存、NvAPI_GPU_GetDynamicPstatesInfoEx 取利用率、NvAPI_GPU_ClientPowerTopologyGetStatus 取整机功耗(单位mW,乘0.001换算成瓦)、时钟与风扇同理,最终统一写入 NWLIB_GPU_DEV(nvidia_gpu.c)。
ADL2实战:AMD的Overdrive版本迷宫 🔴
AMD模块位于 amd_gpu.c,通过 adl.c 动态加载 atiadlxx.dll 并导出 ADL2_* 系列函数指针。
1. 先修"坏数据"再干活。 ADL上报的VendorID字段经常是错的(AMD报 0x3EA 而不是 0x1002),NWinfo直接从设备UDID字符串 PCI\VEN_xxxx 中解析出正确的VID来修正(amd_gpu.c),并按 Bus/Device 去重。
2. 探测Overdrive能力等级。 get_overdrive_version 依次尝试 OD Caps(新一代)→ OD6 → OD5,得到能力等级后按等级读取:
- OD5:温度、电压、核心/显存频率、风扇转速
- OD6:整机功耗、实时状态
- OD7+(OverdriveN):边缘/热点温度、性能状态
3. PMLog是新一代ASIC的传感器入口。 对于 AI 家族及以上的新卡(init_pmlog),NWinfo会创建PMLog设备并以1000ms采样率启动传感器记录;读取时优先查PMLog缓冲,其次查OD8日志,最后才用传统OD接口(get_adl_sensor)。温度会按 Edge → Hotspot → VRSoC → SoC 的顺序逐级回退,功耗同理尝试 Board/GFX/ASIC 等多种传感器。
IGCL实战:Intel核显的遥测魔法 🔵
Intel模块位于 intel_gpu.c,使用的IGCL(Intel GPU Control Library)是对Intel Control API的封装,igcl.c 负责按位数加载 ControlLib.dll 或 ControlLib32.dll 并解析函数指针。
1. 枚举与过滤。 IGCL_Init 时启用 CTL_INIT_FLAG_USE_LEVEL_ZERO 标志,枚举后只保留 device_type == CTL_DEVICE_TYPE_GRAPHICS 且 pci_vendor_id == 0x8086 的适配器(intel_gpu.c),这样NPU等其他设备不会混进来。
2. 一次调用拿回整包遥测。 与NVIDIA"一个接口一个数据"不同,IGCL_PowerTelemetryGet 返回的 ctl_power_telemetry_t 一次性包含温度、电压、频率、风扇、能量计数器、活跃度计数器等所有字段(intel_gpu.c)。
3. 功耗与利用率是"算"出来的。 IGCL只提供累积的能量计数器和活跃度计数器,NWinfo记录上一轮的时间戳与计数值,本轮用 差值 ÷ 时间差 实时算出瞬时功耗(W)和利用率(%)——这是硬件遥测工具的经典做法。
4. 显存与PCIe状态。 通过 IGCL_EnumMemoryModules + IGCL_MemoryGetState 逐模块累加总显存与空闲显存(intel_gpu.c);PCIe当前/最大速率由 IGCL_PciGetState / IGCL_PciGetProperties 提供,还能识别 ReBAR 是否支持/已启用。
兜底方案:D3DKMT与DXCore NPU 🛠️
并非所有设备都能被厂商API覆盖,NWinfo还准备了两道"保底":
- d3d_gpu.c:直接调用Windows的
D3DKMT_*内核态接口与DXGI,获取适配器名称、DirectX Feature Level、驱动版本,甚至直接扫描PCI配置空间读取PCIe LinkCap/LinkSta寄存器来补齐速率信息。 - dxcore_npu.cpp:基于Windows 11的DXCore NPU API枚举NPU设备,并在
NWLIB_GPU_DEV.Flags中打上NWLIB_GPU_FLAG_NPU标记。
数据如何变成界面与JSON 📊
采集完成后,NWL_GetGpuInfo 按驱动顺序刷新所有设备,随后 NW_Gpu() 把 NWLIB_GPU_DEV 的字段逐条写入NWinfo的通用节点树(gpu.c):设备名、PCI位置、PnP ID、当前/最大PCIe链接、DirectX版本、GPU利用率、温度、显存总量/空闲/占用率、功耗、频率、电压、风扇转速。GUI、CLI、JSON/YAML/HTML导出共用这一份数据,保证所有出口一致。
核心源码路径速查
| 功能 | 文件 |
|---|---|
| 统一GPU数据结构 | libnw/gpu/gpu.h |
| 驱动注册与数据汇聚 | libnw/gpu.c |
| NVIDIA:NVAPI调用 | libnw/gpu/nvidia_gpu.c |
| NVIDIA:DLL动态加载 | libnw/gpu/nvapi.c |
| AMD:ADL2调用 | libnw/gpu/amd_gpu.c |
| AMD:DLL动态加载 | libnw/gpu/adl.c |
| Intel:IGCL调用 | libnw/gpu/intel_gpu.c |
| Intel:DLL动态加载 | libnw/gpu/igcl.c |
| 通用兜底:D3DKMT | libnw/gpu/d3d_gpu.c |
| NPU枚举:DXCore | libnw/gpu/dxcore_npu.cpp |
小结
NWinfo读取GPU数据的精髓可以概括为三点:统一结构体抹平厂商差异、DLL动态加载保证无驱动环境也不崩溃、多级版本回退应对驱动API演进。想深入了解某一家厂商的具体字段映射,直接打开上表对应的源码文件即可。