Software:User-Mode Driver Framework

From HandWiki
Short description: Driver development platform for Microsoft Windows
User-Mode Driver Framework (UMDF)
Developer(s)Microsoft
Initial releaseOctober 12, 2004; 19 years ago (2004-10-12)
Stable release
2.27 / March 24, 2019; 5 years ago (2019-03-24)
Repositorygithub.com/microsoft/Windows-Driver-Frameworks
Written inC, C++
Operating systemMicrosoft Windows
TypeDevice-driver development platform
LicenseMIT License
Websitedocs.microsoft.com/en-us/windows-hardware/drivers/wdf/overview-of-the-umdf

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]

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 or 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

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

References

External links