User-Mode Driver Framework
User-Mode Driver Framework (UMDF) is a device-driver development platform first introduced with Microsoft's Windows Vista operating system, and is also available for Windows XP. It facilitates the creation of drivers for certain classes of devices.[1]
Developer(s) | Microsoft |
---|---|
Initial release | October 12, 2004 |
Stable release | 2.27
/ March 24, 2019 |
Repository | github |
Written in | C, C++ |
Operating system | Microsoft Windows |
Type | Device-driver development platform |
License | MIT License |
Website | docs |
Overview
Standard device drivers can be difficult to write because they must handle a very wide range of system and device states, particularly in a multithreaded software environment. Badly written device drivers can cause severe damage to a system (e.g., BSoD and data corruption) since all standard drivers have high privileges when accessing the kernel directly. The User-Mode Driver Framework insulates the kernel from the problems of direct driver access, instead providing a new class of driver with a dedicated application programming interface at the user level of interrupts and memory management. If an error occurs, the new framework allows for an immediate driver restart without impacting the system. This is particularly useful for devices that are intermittently connected to the system or support hot swapping via a bus technology such as USB or FireWire.
According to Microsoft, UMDF drivers are simpler to write and debug than kernel-mode drivers.[2] However, UMDF would not be used for performance-intensive or highly stateful devices.
The first version of the UMDF was shipped as part of Windows Media Player version 10 on 2004-10-12. Code-named "Crescent", it was designed to support the Media Transfer Protocol driver, and no public interfaces or documentation were provided for it. Later, Microsoft decided to turn UMDF into a device driver development platform.[3]
Version history
- User-Mode Driver Framework 1.5-1.9, supports Windows XP and newer.
- User-Mode Driver Framework 1.11, supports Windows Vista and later, and Windows Server 2008 and later.[4]
- User-Mode Driver Framework 2.0, which supports Windows 8.1 and newer.[5]
Architecture
A UMDF Driver is a DLL based on Microsoft's Component Object Model (COM). However, UMDF does not use COM for loading, unloading, or controlling concurrency; it only uses COM as a programming pattern, for example exploiting COM's IUnknown interface. At startup, UMDF calls DllGetClassObject to get a pointer to an IClassFactory interface in the driver and then uses the CreateInstance method of the IClassFactory interface to create an instance of the driver callback object.
The driver object is an instance of the framework-provided IWDFDriver interface. The driver provides a set of callbacks via the IDriverEntry COM interface, which is the main entry point for driver customization.
See also
- Windows Driver Frameworks (WDF)
- Kernel-Mode Driver Framework (KMDF)
References
- Programming Drivers for the UMDF
- "Advantages of Writing UMDF Drivers".
- Charles Torre, Peter Wieland (2006-09-18). "Peter Wieland: User Mode Driver Framework". Channel 9. Microsoft. Retrieved 2006-09-18.
- Microsoft Support. "User-Mode Driver Framework version 1.11 update for Windows Vista, Windows Server 2008, Windows 7, and Windows Server 2008 R2". Microsoft. Retrieved 2012-12-01.
- "User-Mode Driver Framework Frequently Asked Questions (Windows Drivers)". Microsoft. Retrieved 2014-06-04.
External links
- Official website
- Peter Wieland's blog – developer lead on the UMDF team at Microsoft