Qt在Windows上的设备热插拔检测技术分析

科技   2024-11-20 18:43   上海  

设备热插拔检测是指系统能够检测到外部设备连接或断开时产生的事件。在Windows上,Qt应用程序可以通过利用Windows API来实现这一功能。以下是一个详细的技术分析以及代码示例,展示如何在Qt应用程序中检测USB设备的热插拔事件。

技术分析

要在Qt应用程序中实现设备热插拔检测,通常需要以下几个步骤:

  1. 注册设备通知

  • 使用Windows API中的RegisterDeviceNotification函数注册要监听的设备类别,并绑定一个窗口ID。
  • 需要指定设备的GUID(全局唯一标识符)来精确监控特定类型的设备。例如,对于USB设备,可以使用GUID_DEVINTERFACE_USB_DEVICE
  • 处理热插拔事件

    • 通过重写QWidget的nativeEvent虚函数或者QAbstractNativeEventFilter的nativeEventFilter虚函数来处理热插拔事件。
    • 当设备热插拔事件发生时,系统会发送WM_DEVICECHANGE消息,应用程序需要解析这个消息来确定设备是插入还是拔出。
  • 解析设备信息

    • 根据WM_DEVICECHANGE消息中的参数,可以进一步解析设备的信息,如设备类型、设备ID等。
    • 对于USB设备,可以使用PDEV_BROADCAST_HDRPDEV_BROADCAST_DEVICEINTERFACE结构体来获取更多详细信息。

    代码示例

    以下是一个简单的代码示例,展示如何在Qt应用程序中检测USB设备的热插拔事件:

    #include <QApplication>
    #include <QMainWindow>
    #include <QDebug>
    #include <Windows.h>
    #include <Dbt.h>
    #include <devguid.h>
    #include <initguid.h>
    #include <usbiodef.h>

    class DeviceHotplug : public QObject
    {
        Q_OBJECT
    public:
        explicit DeviceHotplug(QObject *parent = nullptr);
        ~DeviceHotplug();
        void init();

    signals:
        void deviceAttached(quint16 vid, quint16 pid);
        void deviceDetached(quint16 vid, quint16 pid);

    protected:
        bool nativeEventFilter(const QByteArray &eventType, void *message, long *result) override;

    private:
        HWND hwnd;
    };

    DeviceHotplug::DeviceHotplug(QObject *parent) : QObject(parent)
    {
        hwnd = CreateWindowEx(0, TEXT("Static"), TEXT(""), WS_OVERLAPPEDWINDOW,
                              CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT,
                              NULLNULL, GetModuleHandle(NULL), NULL);
        ShowWindow(hwnd, SW_HIDE);
        init();
    }

    DeviceHotplug::~DeviceHotplug()
    {
        if (hwnd)
        {
            DestroyWindow(hwnd);
        }
    }

    void DeviceHotplug::init()
    {
        DEV_BROADCAST_DEVICEINTERFACE filter;
        ZeroMemory(&filter, sizeof(filter));
        filter.dbcc_size = sizeof(DEV_BROADCAST_DEVICEINTERFACE);
        filter.dbcc_devicetype = DBT_DEVTYP_DEVICEINTERFACE;
        filter.dbcc_classguid = GUID_DEVINTERFACE_USB_DEVICE;

        RegisterDeviceNotification(hwnd, &filter, DEVICE_NOTIFY_WINDOW_HANDLE);

        qApp->installNativeEventFilter(this);
    }

    bool DeviceHotplug::nativeEventFilter(const QByteArray &eventType, void *message, long *result)
    {
        MSG *msg = reinterpret_cast<MSG*>(message);
        if (msg->message == WM_DEVICECHANGE)
        {
            PDEV_BROADCAST_HDR lpdb = (PDEV_BROADCAST_HDR)msg->lParam;
            switch (msg->wParam)
            {
            case DBT_DEVICEARRIVAL:
                if (lpdb->dbch_devicetype == DBT_DEVTYP_DEVICEINTERFACE)
                {
                    PDEV_BROADCAST_DEVICEINTERFACE lpdbdi = (PDEV_BROADCAST_DEVICEINTERFACE)lpdb;
                    // 这里可以解析设备ID等详细信息
                    qDebug() << "USB Device Attached";
                    emit deviceAttached(00)// 发送设备插入信号,这里vid和pid为示例
                }
                break;
            case DBT_DEVICEREMOVECOMPLETE:
                if (lpdb->dbch_devicetype == DBT_DEVTYP_DEVICEINTERFACE)
                {
                    PDEV_BROADCAST_DEVICEINTERFACE lpdbdi = (PDEV_BROADCAST_DEVICEINTERFACE)lpdb;
                    // 这里可以解析设备ID等详细信息
                    qDebug() << "USB Device Detached";
                    emit deviceDetached(00)// 发送设备拔出信号,这里vid和pid为示例
                }
                break;
            }
        }
        return QObject::nativeEventFilter(eventType, message, result);
    }

    int main(int argc, char *argv[])
    {
        QApplication app(argc, argv);
        DeviceHotplug filter;

        QObject::connect(&filter, &DeviceHotplug::deviceAttached,
                         [](quint16 vid, quint16 pid){
                             qDebug() << "Device Attached:" << QString::number(vid, 16) << QString::number(pid, 16);
                         });

        QObject::connect(&filter, &DeviceHotplug::deviceDetached,
                         [](quint16 vid, quint16 pid){
                             qDebug() << "Device Detached:" << QString::number(vid, 16) << QString::number(pid, 16);
                         });

        QMainWindow w;
        w.resize(600500);
        w.setWindowTitle("DeviceHotplug Example");
        w.show();

        return app.exec();
    }

    #include "main.moc"

    总结

    通过上述代码示例,我们可以看到在Qt应用程序中利用Windows API实现设备热插拔检测的基本步骤。这种方法不仅可以用于USB设备,还可以扩展到其他类型的设备,只需更改相应的设备GUID即可。在实际应用中,可以根据具体需求对代码进行进一步优化和扩展。


    Qt教程
    致力于Qt教程,Qt技术交流,研发
     最新文章