UMDF例子 - Windows-driver-samples\general\echo\umdf2
1、编译
包含driver和exe两个项目
VS2015编译结果：
driver - echo.dll echoum.inf wudf.cat （dll及cat需要数字签名）
exe - echoapp.exe
2、安装及卸载
pnputil - windows vista及以上系统内置
devcon - windows kits 或 winddk
2.1 pnputil
> pnputil /add-driver echoum.inf /installMicrosoft PnP 工具正在添加驱动程序包: echoum.inf
已成功添加驱动程序程序包。
发布名称: oem9.inf
驱动程序包已安装在设备上: ROOT\GENERIC\0000驱动程序包总数: 1
已添加驱动程序包数: 1> pnputil /delete-driver oem9.inf /uninstall
Microsoft PnP 工具已卸载驱动程序包。
已成功删除驱动程序程序包。2.2 devcon
替换设备控制台 (DevCon.exe) - Windows drivers | Microsoft Learn
https://learn.microsoft.com/zh-cn/windows-hardware/drivers/devtest/devcon-migration
> devcon install echoum.inf root\ECHO
Device node created. Install is complete when drivers are installed...
Updating drivers for root\ECHO from C:\test\umdf\echoum.inf.
Drivers installed successfully.> devcon remove root\ECHO
ROOT\GENERIC\0000 : Removed
ROOT\GENERIC\0001 : Removed
2 device(s) were removed.3、说明
3.1 安装成功
设备管理器新增一个设备类型Generic，该类型下新增一个设备 Sample UMDF v2 ECHO Driver；
services.exe 进程启动一个子进程 WUDFHost.exe，WUDFHost.exe 加载 echo.dll 驱动模块；
3.2 安装过程中遇到失败
>devcon install echoum.inf root\ECHO
Device node created. Install is complete when drivers are installed...
Updating drivers for root\ECHO from D:\test\umdf\echoum.inf.
devcon failed.>pnputil /add-driver echoum.inf /install
Microsoft PnP 工具正在添加驱动程序包: echoum.inf
无法添加驱动程序包: 试图将驱动程序添加到存储区时遇到问题。驱动程序包总数: 1
已添加驱动程序包数: 0查看日志 C:\Windows\INF\setupapi.dev.log
当前例子，echoum.inf 文件说明部分要求操作系统版本>=Windows 10 1809
命令行执行 winver，查看当前操作系统版本
3.3 卸载
设备管理器删除了新增的设备；
WUDFHost.exe 结束；
3.4 UMDF版本
INF文件UmdfLibraryVersion字段，表示当前驱动模块使用的UMDF版本：
[Echo_Install]
UmdfLibraryVersion=2.15.0
ServiceBinary=%13%\echo.dll可通过VS项目属性/Driver Settings/Driver Model配置。
4、UMDF 版本历史记录
UMDF 版本历史记录 - Windows drivers | Microsoft Learnhttps://learn.microsoft.com/zh-cn/windows-hardware/drivers/wdf/umdf-version-history
| UMDF 版本 | 初始版本 | 包含于 | 使用此 UMDF 版本的驱动程序运行 |
|---|---|---|---|
| 2.33 | Windows 11 版本 21H2 WDK；适用于 Windows Server 2022 的 WDK | Windows 11 版本 24H2；Windows 11 版本 23H2；Windows 11 版本 22H2；Windows 11 版本 21H2；Windows Server 2022 | Windows 11 版本 21H2 及更高版本；Windows Server 2022 及更高版本 |
| 2.31 | Windows 10，版本 2004 WDK | Windows 10 版本 2004（2020 年 5 月更新，Vibranium） | Windows 10 2004 版及更高版本 |
| 2.29 | 未在 WDK 中发布 | Windows 10 版本 1903（2019 年 3 月更新，19H1） | Windows 10 版本 1903 和更高版本 |
| 2.27 | Windows 10，版本 1809 WDK | Windows 10 版本 1809（2018 年 10 月更新，Redstone 5） | Windows 10 版本 1809 及更高版本 |
| 2.25 | Windows 10，版本 1803 WDK | Windows 10 版本 1803（2018 年 4 月更新，Redstone 4） | Windows 10 版本 1803 或更高版本 |
| 2.23 | Windows 10，版本 1709 WDK | Windows 10 版本 1709 (Fall Creators Update, Redstone 3) | Windows 10 1709 版及更高版本 |
| 2.21 | Windows 10，版本 1703 WDK | Windows 10 版本 1703 (Creators Update, Redstone 2) | Windows 10 版本 1703 及更高版本 |
| 2.19 | Windows 10，版本 1607 WDK | Windows 10 版本 1607（周年更新，Redstone 1） | Windows 10 版本 1607，Windows Server 2016 和更高版本 |
| 2.17 | Windows 10，版本 1511 WDK | Windows 10 版本 1511（11 月更新，Threshold 2） | Windows 10 版本 1511，Windows Server 2016 和更高版本 |
| 2.15 | windows 10 WDK | Windows 10 版本 1507 (Threshold 1) | Windows 10 版本 1507，Windows Server 2016 和更高版本 |
| 2.0 | Windows 驱动程序工具包 (WDK) 8.1 | Windows 8.1 | Windows 8.1 及更高版本 |
| 1.11 | Windows 驱动程序工具包 (WDK) 8 | Windows 8 | Windows Vista 及更高版本 |
| 1.9 | windows 7 WDK | Windows 7 | Windows XP 及更高版本 |
| 1.7 | Windows Server 2008 WDK | Windows Vista Service Pack 1 (SP1)，Windows Server 2008 | Windows XP 及更高版本 |
| 1.5 | Windows Vista WDK | Windows Vista | Windows XP 及更高版本 |