usbview 源码结构分析

最新推荐文章于 2021-08-24 14:30:39 发布
最新推荐文章于 2021-08-24 14:30:39 发布
阅读量5.6k 收藏 13
点赞数 2
分类专栏： 驱动 文章标签： usbview 代码
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/v6543210/article/details/37922537
版权


usbview 是微软随wdk 一起发布的一个usb设备查看源码，能够对系统中全部的USB设备进行枚举，可以查看每个设备的详细信息。既使没有安装相应的驱动也可以。

如何编译请参考：

http://blog.csdn.net/chenyujing1234/article/details/7577320

这篇文章对于这个程序的大体逻辑已经分析的差不多了，因为本人工作需也对该程序进行了深入的研究，花费了很多的时间，这里把我的一些个人所得记录下来，以助他人。

知识在于共享嘛！

一、整体介绍

微软已经对该程序进行了更新，代码位于

http://code.msdn.microsoft.com/windowshardware/USBView-sample-application-e3241039/

但是这个代码只能在vs2012及以上中使用，且只支持window7以上操作系统。

本文所用的代码可以在winDDK  7600的安装目录下找到。 src/usb下面。

程序用C写成，且年代较为久远，约为2001年左右完成后经部分修改的，所以到处带着C时代的痕迹。ALLOC到处都有，内存管理异常繁琐，那时候的程序员真的好累啊！


二、核心代码介绍

最核心的函数就是

EnumerateHubPorts (
    HTREEITEM   hTreeParent,
    HANDLE      hHubDevice,
    ULONG       NumPorts
)

对USB设备的枚举都在这个函数中实现 


        success = DeviceIoControl(hHubDevice,
                                  IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX,
                                  connectionInfoEx,
                                  nBytesEx,
                                  connectionInfoEx,
                                  nBytesEx,
                                  &nBytesEx,
                                  NULL);

用这个函数取得设备连接的信息，保存在 connectionInfoEx结构中


如果有设备连接这个端口，并且程序设置获取配置描述性信息，则

        if (gDoConfigDesc &&
            connectionInfoEx->ConnectionStatus == DeviceConnected)
        {
            configDesc = GetConfigDescriptor(hHubDevice,
                                             index,
                                             0);
        }
gDoConfigDesc是全局变量，是由程序一个菜单项控制是否枚举设备的配置信息，默认为false。 


GetConfigDescriptor (
    HANDLE  hHubDevice,
    ULONG   ConnectionIndex,
    UCHAR   DescriptorIndex
)
这个函数是核心中的核心，因为我们想要得到的信息基本上就靠这个了。

开始申请了一段内存，它的大小是 2个结构体大小之和。       

    UCHAR   configDescReqBuf[sizeof(USB_DESCRIPTOR_REQUEST) +
                             sizeof(USB_CONFIGURATION_DESCRIPTOR)];

看下面就明白了，前面保存的是 REQUEST，后面保存的是 CONFIGURATION_DESCRIPTOR类型

    configDescReq = (PUSB_DESCRIPTOR_REQUEST)configDescReqBuf;
    configDesc = (PUSB_CONFIGURATION_DESCRIPTOR)(configDescReq+1);

再看下一段代码，对configDescReq进行赋值，这个是什么呢，就是对USB设备进行查询的请求。

参考：http://www.usb.org/developers/docs/usb_31_031114.zip   9.2节

通过DeviceIOControl函数发送给USB设备，然后设备会进行回复，回复的信息保存在ConfigDescReq中。

   //
    // USBHUB uses URB_FUNCTION_GET_DESCRIPTOR_FROM_DEVICE to process this
    // IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION request.
    //
    // USBD will automatically initialize these fields:
    //     bmRequest = 0x80
    //     bRequest  = 0x06
    //
    // We must inititialize these fields:
    //     wValue    = Descriptor Type (high) and Descriptor Index (low byte)
    //     wIndex    = Zero (or Language ID for String Descriptors)
    //     wLength   = Length of descriptor buffer
    //
    configDescReq->SetupPacket.wValue = (USB_CONFIGURATION_DESCRIPTOR_TYPE << 8)
                                        | DescriptorIndex;

    configDescReq->SetupPacket.wLength = (USHORT)(nBytes - sizeof(USB_DESCRIPTOR_REQUEST));

    // Now issue the get descriptor request.
    //
    success = DeviceIoControl(hHubDevice,
                              IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION,
                              configDescReq,
                              nBytes,
                              configDescReq,
                              nBytes,
                              &nBytesReturned,
                              NULL);

通过这个函数得到 回复信息的长度。

   nBytes = sizeof(USB_DESCRIPTOR_REQUEST) + configDesc->wTotalLength;
然后再ALLOC 一块内存，用来保存配置信息 

    configDescReq = (PUSB_DESCRIPTOR_REQUEST)ALLOC(nBytes);

再次DeviceIoControl将获取的配置信息保存在configDescReq中。注意这个内存最前面的是请求，真正的信息是在后面一段。这个地方直接将这个地址返回

然后对这块信息进行处理， 注意看 configDesc+1的地方，把请求的信息跳过了。

AreThereStringDescriptors函数只是比较简单地检查是否存在描述信息。

存在的话，就通过GetAllStringDescriptors获取相关信息

       if (configDesc != NULL &&
            AreThereStringDescriptors(&connectionInfoEx->DeviceDescriptor,
                                      (PUSB_CONFIGURATION_DESCRIPTOR)(configDesc+1)))
        {
            stringDescs = GetAllStringDescriptors(
                              hHubDevice,
                              index,
                              &connectionInfoEx->DeviceDescriptor,
                              (PUSB_CONFIGURATION_DESCRIPTOR)(configDesc+1));
        }

GetAllStringDescriptors这个函数值得研究，因为它要从configDesc中取出我们需要的信息

函数后面通过一个while循环获取配置信息和接口信息。

PSTRING_DESCRIPTOR_NODE
GetAllStringDescriptors (
    HANDLE                          hHubDevice,
    ULONG                           ConnectionIndex,
    PUSB_DEVICE_DESCRIPTOR          DeviceDesc,
    PUSB_CONFIGURATION_DESCRIPTOR   ConfigDesc
)
{
    PSTRING_DESCRIPTOR_NODE supportedLanguagesString;
    PSTRING_DESCRIPTOR_NODE stringDescNodeTail;
    ULONG                   numLanguageIDs;
    USHORT                  *languageIDs;

    PUCHAR                  descEnd;
    PUSB_COMMON_DESCRIPTOR  commonDesc;

    //
    // Get the array of supported Language IDs, which is returned
    // in String Descriptor 0
    //
    supportedLanguagesString = GetStringDescriptor(hHubDevice,
                                                   ConnectionIndex,
                                                   0,
                                                   0);

    if (supportedLanguagesString == NULL)
    {
        return NULL;
    }

    numLanguageIDs = (supportedLanguagesString->StringDescriptor->bLength - 2) / 2;

    languageIDs = &supportedLanguagesString->StringDescriptor->bString[0];

    stringDescNodeTail = supportedLanguagesString;

    //
    // Get the Device Descriptor strings
    //

    if (DeviceDesc->iManufacturer)
    {
        stringDescNodeTail = GetStringDescriptors(hHubDevice,
                                                  ConnectionIndex,
                                                  DeviceDesc->iManufacturer,
                                                  numLanguageIDs,
                                                  languageIDs,
                                                  stringDescNodeTail);
    }

    if (DeviceDesc->iProduct)
    {
        stringDescNodeTail = GetStringDescriptors(hHubDevice,
                                                  ConnectionIndex,
                                                  DeviceDesc->iProduct,
                                                  numLanguageIDs,
                                                  languageIDs,
                                                  stringDescNodeTail);
    }

    if (DeviceDesc->iSerialNumber)
    {
        stringDescNodeTail = GetStringDescriptors(hHubDevice,
                                                  ConnectionIndex,
                                                  DeviceDesc->iSerialNumber,
                                                  numLanguageIDs,
                                                  languageIDs,
                                                  stringDescNodeTail);
    }


    //
    // Get the Configuration and Interface Descriptor strings
    //

    descEnd = (PUCHAR)ConfigDesc + ConfigDesc->wTotalLength;

    commonDesc = (PUSB_COMMON_DESCRIPTOR)ConfigDesc;

    while ((PUCHAR)commonDesc + sizeof(USB_COMMON_DESCRIPTOR) < descEnd &&
           (PUCHAR)commonDesc + commonDesc->bLength <= descEnd)
    {
        switch (commonDesc->bDescriptorType)
        {
            case USB_CONFIGURATION_DESCRIPTOR_TYPE:
                if (commonDesc->bLength != sizeof(USB_CONFIGURATION_DESCRIPTOR))
                {
                    OOPS();
                    break;
                }
                if (((PUSB_CONFIGURATION_DESCRIPTOR)commonDesc)->iConfiguration)
                {
                    stringDescNodeTail = GetStringDescriptors(
                                             hHubDevice,
                                             ConnectionIndex,
                                             ((PUSB_CONFIGURATION_DESCRIPTOR)commonDesc)->iConfiguration,
                                             numLanguageIDs,
                                             languageIDs,
                                             stringDescNodeTail);
                }
                (PUCHAR)commonDesc += commonDesc->bLength;
                continue;

            case USB_INTERFACE_DESCRIPTOR_TYPE:
                if (commonDesc->bLength != sizeof(USB_INTERFACE_DESCRIPTOR) &&
                    commonDesc->bLength != sizeof(USB_INTERFACE_DESCRIPTOR2))
                {
                    OOPS();
                    break;
                }
                if (((PUSB_INTERFACE_DESCRIPTOR)commonDesc)->iInterface)
                {
                    stringDescNodeTail = GetStringDescriptors(
                                             hHubDevice,
                                             ConnectionIndex,
                                             ((PUSB_INTERFACE_DESCRIPTOR)commonDesc)->iInterface,
                                             numLanguageIDs,
                                             languageIDs,
                                             stringDescNodeTail);
                }
                (PUCHAR)commonDesc += commonDesc->bLength;
                continue;

            default:
                (PUCHAR)commonDesc += commonDesc->bLength;
                continue;
        }
        break;
    }

    return supportedLanguagesString;
}


OK这些信息获取完毕，再判断连接的是hub 还是设备， 如果是Hub ，则继续对 hub进行枚举


                if (EnumerateHub(hTreeParent, 
                             extHubName,
                             connectionInfoEx,
                             configDesc,
                             stringDescs,
                             deviceDesc) == FALSE)

如果是设备，则建立一个数据结构  

info = (PUSBDEVICEINFO) ALLOC(sizeof(USBDEVICEINFO));

用来保存设备信息

            info->DeviceInfoType = DeviceInfo;
            info->ConnectionInfo = connectionInfoEx;
            info->ConfigDesc = configDesc;
            info->StringDescs = stringDescs;
再把设备加入到左侧的树中 

            AddLeaf(hTreeParent, 
                            (LPARAM)info,
                            leafName,
                            icon);

info作为一个指针传递给 HTREEITEM  中的lParam，您点击左侧某个设备的时候，就调用display.c中的相关函数 把info中的信息再次解析成文本显示出来


三、我在修改代码中的几个错误

 1.c语言与c++有一些不同的地方。

C语言中可以强制进行指针类型转换，但是C++ 中指针类型转换后无法对指针进行赋值。

(PUCHAR)commonDesc += commonDesc->bLength;
这样的语句会报错，无法对左值赋值。因为这个地方的强制类型转换 将 commonDesc转换为 PUCHAR类型，成为一个值，而不是commonDesc这个变量，无法再进行+=操作。

在修改过程中，我使用了

commonDesc = reinterpret_cast<PUSB_COMMON_DESCRIPTOR> (commonDesc + commonDesc->bLength);
这个是不是看起来非常地正确，非也，必须把后面的commonDesc转换为PUCHAR类型才可以。

这个bug让我的程序出错花了2天才搞定。


2.内存管理

windows对代码质量的追求还是非常高的，这个程序里面用了非常多的ALLOC，要防止内存泄露非常困难。

在usbview.h中定义了

#if DBG

#define ALLOC(dwBytes) MyAlloc(_T(__FILE__), __LINE__, (dwBytes))
#define REALLOC(hMem, dwBytes) MyReAlloc((hMem), (dwBytes))
#define FREE(hMem)  MyFree((hMem))
#define CHECKFORLEAKS() MyCheckForLeaks()

#else
在debug.c中对以上有所实现，将内存分配和回收改成自定义的函数，可以用来对内存泄露进行检查。


在usbview.c 中

在RefreshTree的时候，调用下面的函数，WalTree中 CleanupItem是一个函数指针。

    if (ghTreeRoot)
    {
        WalkTree(ghTreeRoot, CleanupItem, 0);
        TreeView_DeleteAllItems(ghTreeWnd);
        ghTreeRoot = NULL;
    }
在enum.c中 

VOID
CleanupItem (
    HWND      hTreeWnd,
    HTREEITEM hTreeItem
)

获取每个HTREEITEM中的 info指针，然后进行内存释放，确保不存在内存泄露。


附上我用vs2005 做的一个 usbview 的工程，需要安装winddk 7600. 可以编译通过。请各位自行调试查看。

我所做的只是新建一个vs工程，把usbview的文件都拖进来， 添加相应的头文件目录和链接库的目录。

http://download.csdn.net/download/v6543210/7649119


不得不说csdn 网站感觉非常的不稳定，上传非常的慢，有时候会出莫名其妙的错误。因为论坛老了？








路边闲人2
关注
  • 2
    点赞
  • 踩
  • 13
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
USB Tree View修改版本（usbportview-HID.7z）
01-02
看了一下有好多朋友需要USB Tree View 源码，上一个博客工程只给了编译好的dll，还有通过AutoIt 调用的源码，好多朋友可能不熟悉autoit，今天把USB Tree View 修改版源码也分享给大家，希望能给USB开发的朋友带来帮助。 该版本是命令行输出形式，删除了原版本的GUI界面，需要修改为GUI界面的朋友可以自行修改。我的资源如果对你有帮助的话希望能支持点赞，谢谢！
usbtreeview usb接口查看器
07-27
USB Device Tree Viewer是一个非常实用的USB设备查看器，它可以发现所有的usb接口的使用情况，并且提供连接到您的计算机USB设备的信息。
USB HID 多设备检查工具，使用USB Tree View源码修改而来
es15071848238的博客
06-09 1678
最近一直在研究USB HID多设备升级，然后就查看了微软提供的WDKUSB Tree View源码，但是没有找到USB多设备端口绑定的决定因素，当在电脑接上多个相同的USB设备时，就不好判断USB HID设备路径对应的USB端口了。当时修改了USB Tree View源码后就出现了这样的问题，根据PID VID以及设备GUID来判断连到哪个端口，但是很快就被否定了，当接了两台一样的...
usb控制器和usb port之间有什么联系-usbview工具的使用？
tugouxp的专栏
08-24 2553
usbview 是一个可以查看usb 拓扑的工具，可以通过这个工具查看当前USB Host控制器的个数和连接device信息.
USBView VC 源代码
02-22
枚举PC机USB设备类型，USB开发非常重要的源代码，可以显示USB集线器每个端口号
USBView_sample_application.zip
03-21
USBView能够展示这棵树的完整结构，帮助用户了解所有已连接的USB设备及其关系。 2. **dispvid.c**：这个文件可能包含显示视频设备相关功能的代码。在USB设备中，视频捕获设备通常遵循UVC（USB Video Class）标准，...
USB通信源码
01-19
10. **USB调试工具**：例如USBView（Windows）和USBDeview等，可以帮助开发者查看USB设备状态，调试USB通信问题。 在"usb-example"这个源码示例中，可能包含了USB设备枚举、配置选择、端点设置、数据读写等相关代码...
WDK源码中 usbView 例子完整工程代码
11-09
开发者可以通过研究WDK中的USBView源码，学习如何使用Windows驱动模型（WDM）和USB设备类驱动模型（USBDI）来实现对USB设备的操作。 在USBView的源码中，我们可以看到以下几个关键知识点： 1. **设备枚举**：源码...
Usbview_MFC_source源码.zip
09-29
Usbview_MFC_source源码.zip是一个包含USB设备查看器（Usbview）源代码的压缩文件，基于Microsoft Foundation Classes (MFC)框架。MFC是微软为Windows平台开发的一个C++类库，它提供了对Windows API的封装，使得...
usbview 工具包
01-19
usbview 32位和64位版本，用于查看usb端口信息。 windows 10 sdk 内部工具，需要.net 3.5.
UsbTreeView工具
01-23
UsbTreeView工具
真正的usbview源代码
10-25
真正的usbview源代码，带所需头文件及Lib,找了半天，在pudn中找到的，大家共享。 在vc6中link有错，不知为什么；在vs2008中编译通过。
USBVIEW查看系统USB设备ID
01-18
查看系统USB设备ID查看系统USB设备ID查看系统USB设备ID查看系统USB设备ID查看系统USB设备ID查看系统USB设备ID查看系统USB设备ID查看系统USB设备ID
usbtreeview_usbtreeview_USB/WIFI_usb抓包_
09-30
USB的一个抓包工具，支持热插拔，实时查看
最新的WIN8.1 usbview_sample
09-26
USBView的源码可以帮助你了解这些概念是如何在实际应用中实现的。 ### 文件分析 - `description.html`: 这可能包含关于USBView示例项目的详细描述，包括项目背景、目标和使用方法。 - `license.rtf`: 提供了项目...
USBVIEW(带已分配带宽显示功能)-电脑圈圈
ColorFilter
05-25 1616
圈圈大神-荣哥： 之前经常出现一些USB设备带宽分配过高导致同一个主控制器上设备无法使用的情况，针对这个问题我今天搞了一个USB带宽查看工具，可以用来显示某个设备已经分配的USB带宽(单位字节每秒)，这样方便查看每个设备的带宽占用情况，避免某些设备给自己分配不合理的USB带宽。例如要查看摄像头工作状态的带宽占用情况，那么将摄像头按需要的分辨率打开（可以使用amcap、mindlinker等工具），然后打开这个工具，按F5键刷新一下，在左边列表找到我们的设备，点击之后在右边就会显示当前设...
说说usbview
rRoookie的专栏
01-07 3347
对于经常摆弄电脑的兄弟们来说，USBVIEW是一个再熟悉不过的小工具了。 usbview是一个简单小巧，完美展示PC挂接的所有的usb设备，并显示设备的描述信息。 它占地面积极小，只有80k的大小，放在桌面也不会影响电脑的速度和其他性能。 下面展示先其界面和界面信息。 大家可以看到整个软件，没有过多的按钮，没有什么选项，整个界面分左右两块， 左边是usb树，显示电脑上所有的usb设备
Window XP驱动开发(八) WDK源码中 usbView 例子的编译及说明
热门推荐
chenyujing1234的专栏
05-18 1万+
转载请标明是引用于 http://blog.csdn.net/chenyujing1234  欢迎大家提出意见,一起讨论! 示例代码： http://download.csdn.net/detail/chenyujing1234/4352191     1、编译过程 步骤一、加入.h .c .rc文件 将D:\WINDDK\7600.16385.1\src\usb\usbview
枚举usb设备
成都_冉若愚 专栏
06-27 4276
关于usb设备枚举的文档，网上有很多，我是参看WDK目录下，src中关于usbview的文件写的。可能不同环境会有细微差别，我使用vs2008 + 目前最新的ddk。里面没有涉及的定义，可以从usbview里面找到，稍作修改就可以。 bool Cmfc1Dlg::EnumUsbDevice(){ TCHAR        HCName[16]; int         HCNum; PTS
android usbcamera源码
最新发布
11-21
Android USBCamera源码是一个基于Android平台的USB摄像头驱动程序源代码。该源代码提供了对USB摄像头的访问和控制功能，可以实现在Android设备上使用USB摄像头进行拍照、录像和实时预览等操作。 该源码包含了USB设备的连接和通信相关的代码，可以实现通过USB接口连接摄像头设备，并且通过USB协议进行数据传输和控制。同时，该源码还提供了摄像头的硬件相关代码，可以对摄像头的参数进行设置和调整，比如对焦、曝光、白平衡等功能。 除此之外，Android USBCamera源码还包含了图像处理和显示相关的代码，可以实现对摄像头采集的图像进行处理和展示，比如图像的转换、裁剪、滤镜等操作，还可以将图像实时显示在Android设备的屏幕上。 总的来说，Android USBCamera源码为开发者提供了一个完整的USB摄像头驱动程序开发框架，可以方便快速地实现USB摄像头在Android设备上的应用开发。该源码具有丰富的功能和灵活的扩展性，可以满足不同应用场景下的需求，并且可以作为学习和研究USB摄像头驱动程序的参考资料。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

路边闲人2

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值