Windows 下枚举 HID 设备最稳方式是调用 SetupDiGetClassDevs 并传 GUID_DEVINTERFACE_HID，逐个获取硬件 ID 判断 VID/PID，注意句柄释放、路径格式、共享标志及避免 UI 线程阻塞。
Windows 下用 SetupAPI 枚举 HID 设备最稳
直接调 SetupDiGetClassDevs 比轮询注册表或硬查 \.HID#* 路径靠谱得多，系统驱动栈更新后后者容易失效。
- 必须传
GUID_DEVINTERFACE_HID，不能只靠设备名字符串匹配，否则会漏掉复合设备里的非主接口 - 枚举后要逐个调
SetupDiGetDeviceRegistryProperty拿SPDRP_HARDWAREID，靠这个判断是不是你要的 PID/VID，别信SPDRP_FRIENDLYNAME - 常见错误：没调
SetupDiDestroyDeviceInfoList导致句柄泄漏，跑几分钟就ERROR_NO_MORE_ITEMS报错
HidD_GetPreparsedData 前必须先 CreateFile 并设 FILE_SHARE_READ | FILE_SHARE_WRITE
很多 HID 设备（尤其是游戏手柄、带 LED 控制的键盘）在独占模式下会拒绝预解析，CreateFile 失败返回 INVALID_HANDLE_VALUE 但 GetLastError() 是 ERROR_ACCESS_DENIED，不是权限问题，是共享标志没开。
- 路径格式必须是
\\?\hid#vid_046d&pid_c539#7&12345678&0&0000#{4d1e55b2-f16f-11cf-88cb-001111000030}这种完整 Device Interface Path，不能省略\\?\前缀 - 打开后立刻调
HidD_GetAttributes校验 VID/PID，避免设备热插拔后句柄指向旧实例 - 别在 UI 线程里做这个操作——
CreateFile在某些 USB 集线器上会卡 3–5 秒
读写报告时 HidD_SetOutputReport 和 WriteFile 的选择逻辑
绝大多数 HID 设备用 WriteFile 更可控；只有少数固件要求必须走 HidD_SetOutputReport（比如某些指纹模块），否则报告被静默丢弃。
- 用
WriteFile：缓冲区首字节必须是 Report ID（除非设备描述符里bReportID为 0），且长度得包含这个字节 - 用
HidD_SetOutputReport：缓冲区首字节**不能**是 Report ID，系统自动补，传进去的长度也不含它 - 常见坑：
HidD_SetOutputReport返回 TRUE 不代表设备收到了，得配合HidD_GetFeatureReport回读校验，或者监听设备的中断 IN 端点响应
Linux 下别碰 libusb 直接发控制请求
除非你完全掌控固件协议，否则优先走 /dev/hidrawN —— 它由内核 hid-generic 驱动托管，自动处理 report descriptor 解析、report id 映射、大小端转换，libusb 手动构造 URB 容易触发设备 reset。
立即学习“C++免费学习笔记（深入）”；
- open
/dev/hidrawN后记得ioctl(fd, HIDIOCGRAWINFO, &info)拿 vendor/product，别依赖文件名序号 -
read()到的数据是 raw report，首字节就是 Report ID（即使 descriptor 里没定义），应用层要自己按 report descriptor 解包 - 权限问题最常卡人：udev 规则里不加
SUBSYSTEM=="hidraw"，只写SUBSYSTEM=="usb"是无效的
HidD_FlushQueue 才能稳定收数据。 
