Transport minidrivers

This section contains details for vendors who need to create their own HID minidrivers. If your device requires USB, Bluetooth, Bluetooth LE, I²C, GPIO as the transport, use the Microsoft-provided in-box driver. To see the list of in-box transport minidrivers, see HID Transports.

For other transports, you will need to write transport minidrivers.

HID minidrivers can be written by using one of the following frameworks:

  1. UMDF – User Mode Driver Framework
  2. KDMF – Kernel Mode Driver Framework
  3. WDM – Legacy Windows Driver Model

Note Microsoft encourages hardware vendors to use the in-box transport-minidrivers whenever possible. However, if your device requires an unsupported transport, Microsoft recommends using the Windows Driver Framework (UMDF or KMDF) as the driver model for your minidriver. You should only create a WDM minidriver if a specific transport is not supported by the Windows Driver Framework.

Microsoft recommends that developers use the UMDF framework as a starting point. Only if a functionality is not available to UMDF, consider writing a KMDF driver. For information about functionality comparison in the two driver frameworks, see Comparing UMDF 2 Functionality to KMDF.

The following table captures the key advantages and challenges associated with the two WDF models as they pertain to HID Transport minidrivers.

Advantages Support available in all Windows platforms that supports WDF Required for all keyboard and mouse filter drivers. Easier to develop and recommended for most vertical device classes Errors in this driver do not bug check the whole system. For more information, see Advantages of Writing UMDF Drivers.
Challenges Poorly written KDMF HID transport minidrivers can crash the system. UMDF HID transport minidrivers are not supported versions of Windows prior to Windows 8. A UMDF driver can receive I/O requests from a kernel-mode driver. Those transitions can have a slight performance impact.

See Also

Getting Started with UMDF

Send comments about this topic to Microsoft