用setupapi获取硬件id需以管理员权限调用setupdigetclassdevs、setupdienumdeviceinfo和setupdigetdeviceregistryproperty，先查缓冲区大小再读取多字符串格式的devpkey_device_hardwareids，注意接口guid与设备类guid区别及win10/11兼容性限制。
用 SetupAPI 获取硬件 ID 的基本流程
Windows 设备管理器里显示的“硬件 ID”本质是设备实例的 DEVPKEY_Device_HardwareIds 属性值，不能靠注册表直接遍历读取（尤其 Win10/11 后很多设备不写注册表），必须走 SetupAPI。核心函数是 SetupDiGetDeviceRegistryProperty，配合 SetupDiEnumDeviceInfo 和 SetupDiGetClassDevs。
关键点：必须以管理员权限运行程序，否则多数设备（尤其是 PCI、USB 主机控制器等）会返回 ERROR_ACCESS_DENIED；同时要链接 setupapi.lib，并在源文件中 #include <setupapi.h></setupapi.h> 和 #include <devguid.h></devguid.h>。
- 调用
SetupDiGetClassDevs时传NULL作为 ClassGuid 可枚举所有设备，但性能差、易卡顿；推荐按需指定如GUID_DEVCLASS_NET（网卡）、GUID_DEVCLASS_DISPLAY（显卡） - 每次调用
SetupDiEnumDeviceInfo前必须重置设备信息集索引，否则可能跳过设备或崩溃 - 属性缓冲区大小必须先用
SPDRP_HARDWAREID调一次获取所需长度，再分配内存重试，否则返回失败且GetLastError()是ERROR_INSUFFICIENT_BUFFER
读取 HardwareIds 字符串的实际代码片段
DEVPKEY_Device_HardwareIds 返回的是多字符串（multi-string）格式：每个 ID 以 \0 分隔，末尾有两个连续 \0。不能直接当普通 C 字符串用，否则 printf 或 std::string 构造会截断。
以下逻辑必须严格遵循：
- 先调用
SetupDiGetDeviceRegistryProperty传入NULL缓冲区和0长度，获取实际需要的字节数（含结尾双\0） - 分配足够内存（注意是字节而非字符数，
WCHAR下要乘 2），再调第二次真正读取 - 遍历结果时用
while (*p) { printf("%ls\n", p); p += wcslen(p) + 1; }，不能用strtok_s或std::wstringstream直接切分
DWORD size = 0;
SetupDiGetDeviceRegistryProperty(devInfo, &devData, SPDRP_HARDWAREID, NULL, NULL, 0, &size);
if (size == 0) return;
std::vector<wchar> buf(size / sizeof(WCHAR));
SetupDiGetDeviceRegistryProperty(devInfo, &devData, SPDRP_HARDWAREID, NULL, (PBYTE)buf.data(), size, &size);
WCHAR* p = buf.data();
while (*p) {
wprintf(L"%s\n", p);
p += wcslen(p) + 1;
}
</wchar>
常见错误：为什么返回空或 ERROR_INVALID_DATA
最常踩的坑不是权限或链接问题，而是设备接口类（Interface Class）误用。比如想读 USB 设备 ID，却用 GUID_DEVCLASS_USB —— 这个 GUID 实际对应的是 USB 控制器（Root Hub），不是 USB 接口设备。正确做法是：
- USB 设备应枚举
GUID_DEVINTERFACE_USB_DEVICE，然后对每个接口设备调用SetupDiGetDeviceInterfaceDetail获取设备实例 ID，再用该 ID 查询硬件 ID - 显卡、声卡等需用
GUID_DEVINTERFACE_DISPLAY_ADAPTER、GUID_DEVINTERFACE_AUDIO等接口 GUID，而非设备类 GUID - 调用
SetupDiGetDeviceRegistryProperty前必须确保devData.ClassGuid已正确填充（通过SetupDiEnumDeviceInfo获取），否则返回ERROR_INVALID_DATA
兼容性与性能注意事项
Win7 之后部分设备（如 Thunderbolt、某些 PCIe 设备）的硬件 ID 可能包含动态生成字段（如 PCI\VEN_8086&DEV_XXXX&SUBSYS_YYYYZZZZ&REV_XX 中的 SUBSYS 部分），这些字段在不同主板上会变，不能用于唯一设备识别。真正稳定的标识是 DEVPKEY_Device_InstanceId（设备实例路径）或 DEVPKEY_Device_LocationPaths（物理位置路径）。
- 枚举全部设备耗时可达数秒，建议加超时控制或异步线程处理，避免 UI 冻结
- Win11 22H2+ 对某些系统设备（如内核模式驱动设备）限制更严，即使管理员权限也可能返回空 HardwareIds，此时应降级尝试
SPDRP_COMPATIBLEIDS - 32 位程序在 64 位 Windows 上无法读取 64 位驱动设备的硬件 ID（如 WDF 驱动），必须编译为 x64
设备管理器里看到的 ID 是最终呈现结果，底层可能经过多次合并、过滤或格式化，直接读取原始 Registry Property 就是真实数据源，但别指望它和界面完全一致——尤其当设备有多个匹配的 INF 文件时，HardwareIds 列表顺序和内容可能因安装顺序而异。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
