Qt實戰5.如何獲取USB設備信息?

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 下載

完整代碼

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章