You need to enable JavaScript to run this app. 如何在C++ Windows应用中获取USB_BANDWIDTH_INFO结构数据
优惠活动
大模型
产品
解决方案
定价
更多

如何在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 19:54:03