C#使用USBClassLibrary库检测USB设备插拔状态

Owen

发布时间：2026-10-14| 4人浏览过

原创

在C#应用开发场景中，尤其是涉及底层硬件交互的项目，实时感知USB设备的物理连接状态是保障数据完整性与程序稳定性的关键需求。开发者若需快速实现这一功能，USBClassLibrary 提供了一个轻量级的解决方案，通过封装Windows API屏蔽了底层枚举的复杂性。

核心实现逻辑

USBClassLibrary 的核心机制基于事件驱动。该类库内部监听操作系统的USB通知消息，当检测到总线上有设备变更时，会触发相应的事件回调。要实现对特定设备的精准控制，关键在于正确配置供应商ID (VID) 和产品ID (PID)。

第1步：订阅设备接入事件

首先需要将针对设备连接的处理器绑定到库提供的 USBDeviceAttached 事件上。这一步的目的是当任意USB设备（或符合特征的设备）进入系统时，立即接收通知并执行初始化逻辑。

以下是处理该事件的典型代码示例：

private void USBPort_USBDeviceAttached(object sender,
USBClass.USBDeviceEventArgs e)
{
    // 检查当前是否已建立连接，避免重复处理
    if (!MyUSBDeviceConnected)
    {
        // 调用GetUSBDevice验证是否为目标设备
        if(USBClass.GetUSBDevice(MyDeviceVID, MyDevicePID,
        ref USBDeviceProperties, false))
        {
            // 确认为目标设备后，更新全局连接状态
            MyUSBDeviceConnected = true;
            // TODO: 此处可添加打开串口、初始化通信等后续操作
        }
    }
}

在该段逻辑中：

MyUSBDeviceConnected 是一个布尔标志位，用于防止系统在未断开前重复触发接入逻辑。
USBClass.GetUSBDevice 函数用于二次确认，传入预设的 MyDeviceVID 和 MyDevicePID。这确保了即使是非目标设备的干扰也能被过滤，仅当返回值为真时，才认为特定的硬件已成功挂载。

第2步：订阅设备移除事件

除了接入，及时的资源释放同样重要。通过绑定 USBDeviceRemoved 事件，可以在物理连接断开的第一时间重置软件层面的状态，防止因设备消失而导致的IO错误或异常崩溃。

对应的处理代码如下：

private void USBPort_USBDeviceRemoved(object sender,
USBClass.USBDeviceEventArgs e)
{
    // 再次利用GetUSBDevice进行存在性校验
    if(!USBClass.GetUSBDevice(MyDeviceVID, MyDevicePID,
    ref USBDeviceProperties, false))
    {
        // GetUSBDevice返回false意味着设备不再处于列表中
        MyUSBDeviceConnected = false;
        // TODO: 此处应包含关闭文件句柄、停止线程等清理工作
    }
}

这里的关键在于判断条件：如果 GetUSBDevice 无法在当前的设备树中找到指定的 VID/PID 组合，则证明设备确实已被移除，此时应将连接标志位 MyUSBDeviceConnected 置为 false。

注意事项与排错建议

Vid/Pid 匹配精度： 务必确认项目中使用的 MyDeviceVID 和 MyDevicePID 十六进制字符串与实际硬件完全一致。任何一位字符的错误都会导致检测失败。
多实例防护： 上述代码结构采用了互斥锁的思想（通过布尔变量），在实际工程应用中，如果多线程环境下对UI控件或共享内存进行操作，需注意线程安全，必要时加入 lock 关键字或使用 Invoke。
依赖引用： 使用前请确保已在项目中正确添加了 USBClassLibrary.dll 的引用，并检查目标运行环境的架构（x86/x64）是否与库匹配。