NWinfo如何读取GPU数据?NVAPI、ADL2与IGCL三大GPU API实战揭秘

原创2026-11-01 19:25:531,899 阅读

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演进。想深入了解某一家厂商的具体字段映射,直接打开上表对应的源码文件即可。

登录后查看全文
nwinfo