Qt实战5.如何获取USB设备信息?

时间:2024-03-07 15:19:44

1 需求描述

  1. 实现USB设备的热插拔状态检测;
  2. 可识别USB设备信息,例如PID、VID、设备序列号等。

几年前在CSDN上分享过,被CSDN恶心到了,乱设积分,变相让用户充钱,现重新整理代码进行分享,希望能帮到需要的人。

2 设计思路

2.1 获取USB设备信息的方式?

经过查询,Qt可通过本地事件获取到设备相关信息,用到的的事件函数原型为:
bool QWidget::nativeEvent(const QByteArray &eventType, void *message, long *result)
官方说明:这个特殊的事件处理程序可以在子类中重新实现,以接收在消息参数中传递的由eventType标识的本机平台事件。在这个函数的重新实现中,如果您想要停止Qt正在处理的事件,请返回true并设置result,结果参数仅在Windows上有意义。如果返回false,此本机事件将被传递回Qt,Qt将该事件转换为Qt事件并将其发送给窗口。

注意:只有当窗口具有本地窗口句柄时,事件才会交付给此事件处理程序。

很容易理解吧,对于widget窗口而言,这个事件是源头,Qt封装好的事件都从这里来,如果直接返回true界面将无法显示,有兴趣的朋友可以试试。另外,发现没有这个事件是QWidget的,所以只有窗口界面才有,窗口的句柄可以通过QWidget::winId获取到,这个后面注册设备时会用到。

2.2 准备工作?

如果只是重写nativeEvent是不够的,并不能获取到设备信息,只能识别热插拔状态。要识别USB设备信息需要用到GUID,先定义设备的GUID,再注册设备,注册完成后才能获取对应设备的本地事件,从而通过事件获取到设备信息。

GUID(全称:Globally Unique Identifier)全局唯一标识符,在windows上使用GUID来管理设备,驱动,总线,类型,块设备,电源等。

2.3 常用硬件设备GUID

Identifier Class GUID
GUID_DEVINTERFACE_USB_DEVICE {A5DCBF10-6530-11D2-901F-00C04FB951ED}
GUID_DEVINTERFACE_USB_HOST_CONTROLLER {A5DCBF10-6530-11D2-901F-00C04FB951ED}
GUID_DEVINTERFACE_USB_HUB {F18A0E88-C30C-11D0-8815-00A0C906BED8}
GUID_DEVINTERFACE_NET {CAC88484-7515-4C03-82E6-71A87ABAC361}
GUID_DEVINTERFACE_DISK {53F56307-B6BF-11D0-94F2-00A0C91EFB8B}
GUID_DEVINTERFACE_CDROM {53F56308-B6BF-11D0-94F2-00A0C91EFB8B}
GUID_DEVINTERFACE_KEYBOARD {884B96C3-56EF-11D1-BC8C-00A0C91405DD}
GUID_DEVINTERFACE_MOUSE {378DE44C-56EF-11D1-BC8C-00A0C91405DD}
GUID_DEVINTERFACE_IMAGE {6BDD1FC6-810F-11D0-BEC7-08002BE2092F}
GUID_BTHPORT_DEVICE_INTERFACE {0850302A-B344-4fda-9BE9-90576B8D46F0}
太多了,网上可以搜到,这里就不一一列出。

3 代码实现

windows提供了接口向系统注册设备,注册后当有U盘插拔(或其它volume增删)的时候,会向注册的窗口发送WM_DEVICECHANGE消息:
HDEVNOTIFY WINAPI RegisterDeviceNotification(
__in HANDLE hRecipient, // 可以是窗口句柄或者服务句柄
__in LPVOID NotificationFilter,
__in DWORD Flags // 制定hRecipient是窗口句柄,还是服务句柄
);

  1. 先注册设备,这样才能接收到消息,代码如下:
void Dialog::registerDevice()
{
    const GUID GUID_DEVINTERFACE_LIST[] = {
        { 0xA5DCBF10, 0x6530, 0x11D2, { 0x90, 0x1F, 0x00, 0xC0, 0x4F, 0xB9, 0x51, 0xED } }, //USB设备的GUID
        { 0x53f56307, 0xb6bf, 0x11d0, { 0x94, 0xf2, 0x00, 0xa0, 0xc9, 0x1e, 0xfb, 0x8b } }};

    HDEVNOTIFY hDevNotify;
    DEV_BROADCAST_DEVICEINTERFACE NotifacationFiler;
    ZeroMemory(&NotifacationFiler,sizeof(DEV_BROADCAST_DEVICEINTERFACE));
    NotifacationFiler.dbcc_size = sizeof(DEV_BROADCAST_DEVICEINTERFACE);
    NotifacationFiler.dbcc_devicetype = DBT_DEVTYP_DEVICEINTERFACE;

    for (int i = 0; i < sizeof(GUID_DEVINTERFACE_LIST)/sizeof(GUID); i++)  {
        NotifacationFiler.dbcc_classguid = GUID_DEVINTERFACE_LIST[i];
        hDevNotify = RegisterDeviceNotification((HANDLE)this->winId(), &NotifacationFiler, DEVICE_NOTIFY_WINDOW_HANDLE);
        if (!hDevNotify) {
            qCritical() << QStringLiteral("注册失败!");
        }
    }
}
  1. 通过本地事件获取消息并解析,代码如下:
bool Dialog::nativeEvent(const QByteArray &eventType, void *message, long *result)
{
    Q_UNUSED(eventType);
    Q_UNUSED(result);

    MSG *msg = reinterpret_cast<MSG *>(message);

    int msgType = msg->message;
    if (WM_DEVICECHANGE == msgType) {
        PDEV_BROADCAST_HDR lpdb = (PDEV_BROADCAST_HDR)msg->lParam;
        switch (msg->wParam) {
        case DBT_DEVICEARRIVAL:
        {
            if (DBT_DEVTYP_VOLUME == lpdb->dbch_devicetype) {
                PDEV_BROADCAST_VOLUME lpdbv = (PDEV_BROADCAST_VOLUME)lpdb;
                if (0 == lpdbv->dbcv_flags) { //优盘
                    QString USBDisk = QString(this->firstDriveFromMask(lpdbv ->dbcv_unitmask));
                    ui->labelShowMsg->setText(QString(QStringLiteral("已检测到USB设备插入--盘符:<%1>")).arg(USBDisk));
                } else if (DBTF_MEDIA == lpdbv->dbcv_flags) {
                    qDebug() << "CD_Arrived.";
                }

            } else if (DBT_DEVTYP_DEVICEINTERFACE == lpdb->dbch_devicetype)  {

                PDEV_BROADCAST_DEVICEINTERFACE pDevInf  = (PDEV_BROADCAST_DEVICEINTERFACE)lpdb;
                QString name = QString::fromWCharArray(pDevInf->dbcc_name);
                if (!name.isEmpty()) {
                    if (name.contains("USBSTOR")) {
                        QStringList listAll = name.split(\'#\');
                        QStringList listInfo = listAll.at(1).split(\'&\');
                        m_usbInfoList.append(listInfo.at(1).mid(4)); //设备制造商 3
                        m_usbInfoList.append(listInfo.at(2).mid(5)); //设备型号 4
                        m_usbInfoList.append(listInfo.at(3).mid(4)); //设备版本 5
                    } else {
                        m_usbInfoList.clear();
                        QStringList listAll = name.split(\'#\');
                        QStringList listID = listAll.at(1).split(\'&\');
                        m_usbInfoList.append(listID.at(0).right(4)); //vid 0
                        m_usbInfoList.append(listID.at(1).right(4)); //pid 1
                        m_usbInfoList.append(listAll.at(2)); //设备序列号 2
                    }
                }

                display();
            }
        }
            break;
        case DBT_DEVICEREMOVECOMPLETE:
        {
            if (DBT_DEVTYP_VOLUME == lpdb->dbch_devicetype) {
                PDEV_BROADCAST_VOLUME lpdbv = (PDEV_BROADCAST_VOLUME)lpdb;
                if (0 == lpdbv->dbcv_flags) {
                    ui->labelShowMsg->setText(QString(QStringLiteral("USB设备已拔出!")));
                    QTimer::singleShot(1000, ui->labelShowMsg, SLOT(clear()));
                }

                if (DBTF_MEDIA == lpdbv->dbcv_flags) {
                    ui->labelShowMsg->setText("CD_Removed.");
                }
            }
        }
            break;
        }
    }

    return false;
}

补充下,获取到的USB设备信息原始数据如下,通过上边的代码进行解析,然后显示到界面上。

"\\\\?\\USB#VID_0951&PID_1666#E0D55EA574B4F371679B1A6D#{a5dcbf10-6530-11d2-901f-00c04fb951ed}"
"\\\\?\\USBSTOR#Disk&Ven_Kingston&Prod_DataTraveler_3.0&Rev_#E0D55EA574B4F371679B1A6D&0#{53f56307-b6bf-11d0-94f2-00a0c91efb8b}"

发现没有,这个GUID和我们注册的是不是一模一样,有感觉了吧。如果还想获取其它设备的相关信息,注册少不了,不然就获取不到。再有一个就是,设备信息并不是一个事件就获取完的,从上可以看出,这里用了两次事件才将信息获取完整,即注册过的两个设备,可以尝试将GUID_DEVINTERFACE_LIST列表移除一个GUID,结果是USB设备信息获取不完整了。

4 总结

通过注册设备、接收本地事件、解析事件消息,最终可获取到设备信息。如果想进一步实现特殊功能,比如自定义无边框拉伸、移动等,也可以通过本地事件实现,这需要对windows消息机制进一步学习才行。当然也可以使用Qt封装好的事件进行处理,都是事件,能玩出什么花样就得看自己的能耐了。到这里对windows消息机制应该会有个初步的了解,还是那句话,有个好的开端总是很重要的。

本人对windows这一套也不是很熟悉,网上很多代码都是片段不完整的,后面经过自己的优化改写,最终实现了完整功能。

5 下载

完整代码