如何在C++ Windows应用中获取USB_BANDWIDTH_INFO结构数据
Windows C++ 读取USB带宽占用的实现方案
核心原理
要获取USB_BANDWIDTH_INFO结构的数据,需要向USB主机控制器设备发送指定的IOCTL请求,而非直接读取USB设备属性:
该IOCTL仅能从USB主机控制器设备句柄发起请求,不能直接对USB设备节点发起请求。
具体实现步骤
- 第一步:使用SetupAPI枚举系统中所有USB主机控制器设备,对应接口GUID为
GUID_DEVINTERFACE_USB_HOST_CONTROLLER,获取设备的完整路径。 - 第二步:调用
CreateFile打开主机控制器设备,需要申请GENERIC_READ | GENERIC_WRITE权限,共享模式设置为FILE_SHARE_READ | FILE_SHARE_WRITE。 - 第三步:先发起一次空缓冲区的IOCTL请求,获取实际需要的缓冲区大小,避免内存不足导致数据截断。
- 第四步:分配足够的内存后再次发起IOCTL请求,控制码指定为
IOCTL_USB_GET_BANDWIDTH_INFO,请求成功后即可从输出缓冲区中读取USB_BANDWIDTH_INFO的完整内容。 - 第五步:匹配你使用的USB摄像头对应的总线号、端口号,即可筛选出该设备占用的带宽数据。
核心参考代码
#include <windows.h> #include <usbuser.h> #include <setupapi.h> #pragma comment(lib, "setupapi.lib") void QueryUsbBandwidth(LPCWSTR hostControllerPath) { // 打开USB主机控制器设备 HANDLE hHcd = CreateFileW( hostControllerPath, GENERIC_READ | GENERIC_WRITE, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL ); if (hHcd == INVALID_HANDLE_VALUE) { // 权限不足或路径错误时打开失败,需管理员权限运行程序 return; } DWORD dwReturnedLength = 0; USB_BANDWIDTH_INFO tempInfo = {0}; // 首次调用获取所需缓冲区大小 DeviceIoControl( hHcd, IOCTL_USB_GET_BANDWIDTH_INFO, NULL, 0, &tempInfo, sizeof(USB_BANDWIDTH_INFO), &dwReturnedLength, NULL ); // 计算完整缓冲区大小,包含可变长的总线带宽数组 DWORD dwFullBufferSize = sizeof(USB_BANDWIDTH_INFO) + tempInfo.TotalBusCount * sizeof(USB_BUS_BANDWIDTH_INFO); PUSB_BANDWIDTH_INFO pBandwidthInfo = (PUSB_BANDWIDTH_INFO)HeapAlloc( GetProcessHeap(), HEAP_ZERO_MEMORY, dwFullBufferSize ); if (!pBandwidthInfo) { CloseHandle(hHcd); return; } // 二次调用获取完整带宽数据 BOOL bQuerySuccess = DeviceIoControl( hHcd, IOCTL_USB_GET_BANDWIDTH_INFO, NULL, 0, pBandwidthInfo, dwFullBufferSize, &dwReturnedLength, NULL ); if (bQuerySuccess) { // 全局带宽数据 DWORD totalBandwidth = pBandwidthInfo->TotalBandwidth; DWORD usedBandwidth = pBandwidthInfo->UsedBandwidth; // 遍历每个总线的带宽数据 for (DWORD i = 0; i < pBandwidthInfo->TotalBusCount; i++) { USB_BUS_BANDWIDTH_INFO busInfo = pBandwidthInfo->BusBandwidthInfo[i]; // 可在此处匹配你的摄像头所属总线,获取对应设备的带宽占用 } } // 资源释放 HeapFree(GetProcessHeap(), 0, pBandwidthInfo); CloseHandle(hHcd); }
注意事项
- 程序必须以管理员权限运行,否则无法打开主机控制器设备句柄。
- 不同版本的USB控制器带宽单位不同:USB 2.0总线总带宽为480Mbps,USB 3.0/3.1/3.2分别为5Gbps/10Gbps/20Gbps,需根据控制器类型做单位转换,
USB_BANDWIDTH_INFO返回的数值为底层原始统计值。 - 要定位特定摄像头的带宽占用,需要提前获取该摄像头设备的总线号、端口号,和
USB_BUS_BANDWIDTH_INFO中的对应字段匹配即可。
内容的提问来源于stack exchange,提问作者Charles Tucker 3
相关产品推荐
相关产品推荐

