选择用于开发 USB 客户端驱动程序的驱动程序模型
本文提供了选择最佳驱动程序模型以开发充当设备功能驱动程序的 USB 客户端驱动程序的指南。
USB 设备制造商通常必须为应用程序提供访问设备功能的方法。 若要选择用于访问 USB 设备的最佳机制，请从最简单的方法开始，仅在必要时才迁移到更复杂的解决方案。 以下列表总结了本文中讨论的选项：
- 如果你的设备属于 Windows 包含收件箱驱动程序的 USB 设备类，则无需编写驱动程序。
- 如果设备没有Microsoft提供的类驱动程序，并且只有一个应用程序访问设备，则将 WinUSB 加载为函数驱动程序。
- 如果设备由并发应用程序访问，并且设备没有时序终结点，请编写基于 UMDF 的客户端驱动程序。
- 如果类驱动程序、WinUSB 或 UMDF 解决方案不是适合你的选项，请编写基于 KMDF 的客户端驱动程序。
- 如果 KMDF 不支持特定功能，请编写调用 WDM 例程的混合驱动程序。
最常见的方法是实现设备驱动程序（本文档集中称为 USB 客户端驱动程序 ），并提供安装包，该安装包将驱动程序安装为Microsoft提供的 USB 驱动程序堆栈上方的设备堆栈中的函数驱动程序。 客户端驱动程序公开了应用程序可用于获取设备文件句柄的设备接口。 然后，应用程序可以使用此文件句柄通过调用 Windows API 来与驱动程序通信。
编写根据设备要求自定义的驱动程序是提供对 USB 设备的访问的最灵活方式。 但是，实现驱动程序需要大量工作。 驱动程序必须执行复杂的任务，例如：
- 检测到新设备时驱动程序初始化
- 电源管理
- I/O 操作
- 意外设备删除
- 状态管理
- 删除设备时清理
在选择编写驱动程序之前，请提出以下问题：
是否可以使用Microsoft提供的驱动程序？
如果满足以下条件，则可能需要编写驱动程序：
你的设备属于Microsoft支持的 USB 设备类。
在这种情况下，相应的类驱动程序作为设备驱动程序加载。 有关 Windows 包含收件箱驱动程序的设备类的列表，请参阅 Windows 中包含的 USB 设备类驱动程序。
设备不属于设备类。
对于此类设备，请评估设备功能，以确定是否可以将Microsoft提供的 WinUSB （Winusb.sys） 加载为设备的函数驱动程序。 使用 WinUSB 是最佳解决方案（如果：
设备由单个应用程序访问。
设备支持批量、中断或不连续终结点。
你的设备适用于运行 Windows XP、Service Pack 2（SP2）和更高版本的 Windows 的目标计算机。
将 WinUSB 加载为函数驱动程序提供了一种更简单的替代方法，用于实现自定义 USB 驱动程序。 例如，WinUSB 是仅通过设备打包的应用程序访问的电子气象站的首选方法。 它还可用于与设备进行诊断通信以及刷写固件。
为了方便应用程序向Winusb.sys发送请求，我们提供了公开 WinUSB 函数的用户模式 DLL Winusb.dll。 应用程序可以调用这些函数来访问设备、对其进行配置并将数据传输到设备的终结点。
如果：
设备由多个应用程序访问。
你的设备具有已在 Windows 操作系统中具有内核模式支持的函数。 例如，对于调制解调器功能（TAPI 支持）或 LAN 功能（NDIS 支持），必须使用Usbser.sys驱动程序支持的接口来管理具有用户模式软件的调制解调器设备。
从 Windows 8 开始，我们已将兼容 ID 添加到 INF for WinUSB 安装。 如果设备固件包含兼容的 ID，则默认情况下，WinUSB 将作为设备的函数驱动程序加载。 这意味着硬件制造商不需要为其 WinUSB 设备分发 INF 文件。 有关详细信息，请参阅 WinUSB 设备。
如果编写 USB 客户端驱动程序，哪种驱动程序模型最佳？
答案取决于设备的设计。 首先，确定特定驱动程序模型是否符合要求。 一些设计注意事项基于是否希望多个并发应用程序访问 USB 设备并支持通过时序终结点进行数据流式传输。
如果选择编写驱动程序，可以选择以下选项：
用户模式驱动程序框架 （UMDF）
UMDF 提供设备驱动程序接口（DDI），客户端驱动程序可用于与 Windows 组件（如 即插即用 Manager 和 Power Manager）集成。 UMDF 还为 USB 设备提供专用目标对象，这些对象提取用户模式中的硬件并简化驱动程序的 I/O 操作。 除了 UMDF 接口，WDF 还提供增强的调试器扩展和跟踪工具，用于用户模式驱动程序。 UMDF 基于组件对象模型（COM），开发用户模式驱动程序对于C++开发人员来说更容易。
在以下情况下为 USB 设备实现基于 UMDF 的客户端驱动程序：
设备由多个应用程序并发访问。
设备支持批量传输或中断传输。
在用户模式下运行的驱动程序只能访问（虚拟）用户地址空间，并给系统带来较低的风险。 内核模式驱动程序可以访问系统地址空间和内部系统结构。 编码错误的内核模式驱动程序可能会导致影响其他驱动程序或系统的问题，并最终使计算机崩溃。 因此，在安全性和稳定性方面，用户模式驱动程序比内核模式驱动程序更安全。
用户模式驱动程序的另一个优点是，他们可以使用所有 Win32 API。 例如，驱动程序可以调用 API，例如 Winsock、压缩、加密 API 等。 这些 API 不适用于内核模式驱动程序。
对于支持时序终结点的 USB 设备，不支持基于 UMDF 的客户端驱动程序。
注意
Windows 8.1 引入了 UMDF 版本 2.0。 使用 UMDF 版本 2.0，可以使用 C 编程语言编写 UMDF 驱动程序，以调用 KMDF 驱动程序可用的许多方法。 不能使用 UMDF 版本 2.0 为 USB 编写较低的筛选器驱动程序。
内核模式驱动程序框架 （KMDF）
KMDF 旨在使驱动程序模型易于扩展以支持新类型的硬件。 KMDF 提供 DDI 和数据结构，使内核模式 USB 驱动程序比早期 Windows 驱动程序模型（WDM）驱动程序更容易实现。 此外，KMDF 还提供专用输入/输出（I/O）目标，可用于编写使用 Microsoft USB 驱动程序堆栈的完全功能客户端驱动程序。
在某些情况下，特定功能未通过 KMDF 公开，驱动程序必须调用 WDM 例程。 驱动程序不需要实现整个 WDM 基础结构，而是使用 KMDF 方法访问一组选定的 WDM 例程。 例如，若要执行时序传输，基于 KMDF 的客户端驱动程序可以发送描述 USB 驱动程序堆栈请求的 WDM 样式 URL。 本文档集中的此类驱动程序称为 混合驱动程序 。
KMDF 还支持端口微型端口驱动程序模型。 例如，在上边缘使用内核流式传输的内核流式处理微型端口驱动程序（例如 USB 网络摄像头）可以使用 KMDF USB I/O 目标对象将请求发送到 USB 驱动程序堆栈。 还可以使用 KMDF 为基于协议的总线（如 USB）编写 NDIS 驱动程序。
纯 WDM 驱动程序难以编写、复杂且不可靠。 随着 KMDF 的演变，编写这种类型的驱动程序不再需要。
Microsoft Visual Studio 包括 USB 用户模式驱动程序和 USB 内核模式驱动程序模板，这些模板分别为 UMDF 和 KMDF USB 客户端驱动程序生成初学者代码。 模板代码初始化 USB 目标设备对象，以启用与硬件的通信。 有关详细信息，请参阅以下文章：
有关如何实现 UMDF 和 KMDF 驱动程序的信息，请参阅 Microsoft Press book Developing Drivers with the Windows Driver Foundation.
WinUSB、UMDF、KMDF 功能比较
下表总结了 WinUSB、基于 UMDF 的 USB 驱动程序和基于 KMDF 的 USB 驱动程序的功能。
| 功能 | WinUSB | UMDF | KMDF |
|---|---|---|---|
| 支持多个并发应用程序 | 否 | 是 | 是 |
| 将驱动程序地址空间与应用程序地址空间隔离 | 否 | 是 | 否 |
| 支持批量传输、中断和控制传输 | 是 | 是 | 是 |
| 支持时序传输 | 是 4 | 否 | 是 |
| 支持将内核模式驱动程序（如筛选器驱动程序）作为 USB 堆栈上的过度叠加层安装 | 否 | No | 是 |
| 支持选择性挂起和等待/唤醒状态 | 是 | 是 | 是 |
下表总结了不同版本的 Windows 支持的 WDF 选项。
| Windows 版本 | WinUSB | UMDF | KMDF |
|---|---|---|---|
| Windows 11 | 是 | 是 | 是 |
| Windows 10 | 是 | 是 | 是 |
| Windows 8 | 是 | 是 | 是 |
| Windows 7 | 是 | 是 | 是 |
| Windows Vista | 是1 | 是1 | 是 |
| Windows Server 2003 | 否 | No | 是 |
| Windows XP | 是2 | 是2 | 是 |
| Microsoft Windows 2000 | 否 | 否 | 是3 |
是1：仅在基于 x86 和基于 x64 的 Windows 版本上支持 WinUSB 和 UMDF。
是2：Windows XP 支持 Service Pack 2（SP2）或更高版本的 Windows 中的 WINUSB 和 UMDF。
是3：SP4 或更高版本的 Windows 2000 支持 KMDF。
是4：Windows 8.1 或更高版本的 Windows 支持时序传输。
具有 SP2 的 32 位版本的 Windows XP 的所有客户端 SKU 都支持 WinUSB。 WinUSB 不是 Windows XP 的本机版本，它必须与 WinUSB cointaller 一起安装。 所有 Windows Vista SKU 和更高版本的 Windows 都支持 WinUSB。