如何通过Windows API获取USB 3.2 Gen 2x2(20Gb/s)设备的当前链路通道数

要获取USB 3.2 Gen 2x2（20Gb/s）设备的当前链路通道数，需使用IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V3这个IOCTL控制码——它是IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2的升级版本，专门支持多链路通道的查询。

具体实现步骤： #

• 打开目标USB设备的内核句柄：调用CreateFile函数，传入设备的符号链接路径，权限设置为GENERIC_READ | GENERIC_WRITE，共享模式设为FILE_SHARE_READ | FILE_SHARE_WRITE。
• 准备USB_NODE_CONNECTION_INFORMATION_EX_V3结构体：该结构体包含两个关键字段：
  • ConnectionStatus.DeviceIsOperatingAtSuperSpeedPlusOrHigher：标识设备是否工作在USB 3.2及以上模式；
  • NumberOfActiveLinkChannels：直接返回当前激活的链路通道数（Gen2x2设备正常工作时该值为2）。
• 调用DeviceIoControl函数：传入设备句柄、IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V3控制码，以及结构体缓冲区，获取通道数信息。
• 处理返回结果：若DeviceIoControl调用成功，直接读取NumberOfActiveLinkChannels字段值即可；调用失败时，可通过GetLastError获取错误码排查问题。

关键注意点： #

• 该API仅支持Windows 10 1903及以上版本，需确保系统版本符合要求；
• 操作设备句柄需要管理员权限，否则会调用失败；
• 设备的符号链接路径可通过SetupDiGetClassDevs、SetupDiEnumDeviceInterfaces等SetupAPI函数枚举USB设备获取。

内容的提问来源于stack exchange，提问作者marky1