解决usbipd-win项目中TsUsbFlt驱动兼容性问题

在Windows系统上使用usbipd-win项目进行USB设备重定向时，用户可能会遇到一个常见的兼容性问题：系统提示"USB filter 'TsUsbFlt' is known to be incompatible with this software"。这个问题源于Windows Terminal Server的USB转发功能与usbipd-win的驱动机制存在冲突。

问题根源分析

TsUsbFlt是Windows Terminal Server用于USB设备转发的过滤驱动程序。当系统检测到这个驱动存在时，它会与usbipd-win使用的VBoxUSBMon驱动产生冲突，因为两者都试图控制USB设备的动态绑定过程。这种冲突会导致usbipd-win无法正常绑定USB设备，除非使用强制绑定参数。

解决方案一：禁用TsUsbFlt驱动

最彻底的解决方案是禁用TsUsbFlt驱动，具体步骤如下：

1. 打开注册表编辑器(regedit)
2. 导航至路径：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{36fc9e60-c465-11cf-8056-444553540000}
3. 在该键值下找到并删除名为"UpperFilters"的注册表项
4. 重启计算机使更改生效

这个操作实际上移除了Terminal Server的USB转发过滤驱动，从而消除了与usbipd-win的冲突。需要注意的是，修改注册表前建议先备份相关键值，以防意外情况发生。

解决方案二：使用强制绑定参数

如果用户暂时无法或不想禁用TsUsbFlt驱动，可以使用usbipd-win提供的强制绑定功能：

usbipd bind --force

这个参数会强制将VBoxUSBMon驱动永久安装到目标USB设备上，即使设备未被客户端连接也会持续占用。这种方式的缺点是：

1. 设备将无法被Windows系统直接使用
2. 需要手动执行unbind命令才能恢复设备正常使用

强制绑定适合那些专门用于远程共享、不需要在本地主机上使用的USB设备。

技术背景

usbipd-win在实现USB设备重定向时，会检查系统注册表中是否存在可能冲突的USB过滤驱动。具体来说，它会检查USB设备类GUID下的UpperFilters值。当检测到TsUsbFlt等已知不兼容的驱动时，系统会发出警告并建议使用强制绑定。

对于需要频繁使用USB重定向功能的用户，建议采用第一种解决方案，即完全禁用TsUsbFlt驱动，这样可以获得更稳定和灵活的使用体验。而对于临时使用或特定场景下的需求，强制绑定则提供了快速可用的替代方案。

无论采用哪种方案，用户都应确保了解操作的影响，并在必要时备份系统或相关配置，以避免意外情况导致设备不可用。