Linux下用libusb获取USB设备描述符的典型流程是：先调用libusb_init()初始化上下文，再用libusb_get_device_list()获取设备列表，最后对每个设备调用libusb_get_device_descriptor()直接读取基础描述符；若需字符串描述符，则必须先libusb_open()打开设备，再调用libusb_get_string_descriptor_ascii()转换UTF-8。
Linux下用libusb获取USB设备描述符的典型流程
直接调用系统API读取USB描述符不可行，必须通过用户态USB库（如libusb）与内核USB子系统交互。libusb是跨平台选择，但Linux下需注意权限和udev规则。
关键步骤：
- 调用
libusb_init(NULL)初始化上下文 - 用
libusb_get_device_list()获取设备列表，返回的是libusb_device*指针数组 - 对每个设备调用
libusb_get_device_descriptor()—— 这个函数不需设备句柄，仅靠设备对象就能读取基础描述符（bLength、bDescriptorType、idVendor、idProduct等） - 若要读取字符串描述符（如制造商、产品名），必须先打开设备（
libusb_open()），再用libusb_get_string_descriptor_ascii()，否则返回LIBUSB_ERROR_NOT_FOUND或LIBUSB_ERROR_ACCESS
Windows下用SetupAPI + WinUSB读取时的权限与句柄陷阱
Windows不暴露原始USB描述符给普通应用，必须走 SetupDiGetDeviceRegistryProperty() 查注册表值，或用WinUSB API打开设备后调用 WinUsb_GetDescriptor()。
常见错误：
立即学习“C++免费学习笔记（深入）”；
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 未在INF文件中正确声明
ClassGuid和DriverVer，导致设备被识别为“通用串行总线控制器”，无法加载WinUSB驱动 - 调用
WinUsb_Initialize()前未用CreateFile()以GENERIC_READ | GENERIC_WRITE打开设备路径（格式类似\\?\usb#vid_045e&pid_078f#...#{a5dcbf10-6530-11d2-901f-00c04fb951ed}） - 误以为
WinUsb_GetDescriptor()的DescriptorType参数可直接传USB_DEVICE_DESCRIPTOR_TYPE（实际应为USB_DEVICE_DESCRIPTOR_TYPE宏定义的数值0x01，且需注意字节序）
macOS上IOKit读取描述符为何常卡在IOServiceOpen
macOS要求USB设备必须已由内核扩展（kext）或系统驱动claim，否则 IOServiceOpen() 返回 kIOReturnNotPrivileged；即使有root权限，若设备正被 IOUSBHostFamily 管理，也无法二次open。
可行路径：
- 用
IOServiceMatching("IOUSBDevice")匹配所有USB设备，再用IORegistryEntryCreateCFProperties()读取部分只读属性（如idVendor、idProduct、bcdUSB），这些不需open - 若必须读完整描述符，需在plist中声明
com.apple.security.device.usb权限，并使用IOCreatePlugInInterfaceForService()获取IOUSBDeviceInterface，再调用其GetDeviceDescriptor()方法 - 注意：从macOS 10.15起，未签名kext或未授权的IOKit访问会被系统拦截，调试时需关闭SIP或配置开发证书
跨平台读取字符串描述符时编码与缓冲区的坑
USB字符串描述符是UTF-16LE编码，但libusb/WinUSB/macOS API返回的是原始字节流，直接当C字符串用会崩溃或乱码。
处理建议：
- libusb：用
libusb_get_string_descriptor_ascii()自动转UTF-8，但该函数内部会分配堆内存，需检查返回值是否为负（表示错误），并记得free()结果指针 - WinUSB：
WinUsb_GetDescriptor()返回原始UTF-16LE数据，必须手动转换，推荐用WideCharToMultiByte(CP_UTF8, ...)，注意输入长度单位是字符数而非字节数 - macOS：
CFStringCreateWithBytes()需显式指定kCFStringEncodingUTF16LE，且传入的buffer length 必须是字节数（不是字符数），否则截断
描述符读取本身不难，难在权限模型、驱动绑定状态、字符编码转换这三层嵌套约束——漏掉任意一层，libusb_open() 就会静默失败，WinUsb_Initialize() 返回NULL，或者 IOServiceOpen() 卡住不动。
