本主题提供有关 WDF 验证程序 WDF 驱动程序 页的详细信息。 此页面列出了计算机上的所有 WDF 驱动程序,你可以更改其验证设置以及使用这些驱动程序的设备设置。 如果对特定驱动程序感兴趣,请从此处开始。
启动应用程序时,会看到系统上当前 WDF 驱动程序和运行时版本的列表。 每行都包含驱动程序二进制文件的名称、其服务显示名称、框架版本,以及 KMDF 驱动程序的启动类型。
突出显示驱动程序时,会看到当前使用该驱动程序的任何设备以及相关的 UMDF 主机进程。 仅当选择了正在运行的 UMDF 驱动程序时,主机进程控件才可见。
配色方案
对于每个驱动程序,颜色编码的图标指示它是否使用 KMDF、UMDF 1 或 UMDF 2。
颜色代码指示驱动程序的状态以及需要执行的作,以便对驱动程序的验证设置所做的更改生效。
- Blue 表示驱动程序正在使用,并与一个或多个 PnP 设备相关联。 若要使更改生效,需要禁用和重新启用这些设备。 可以在 “我的首选项 ”选项卡上选择 WDF 验证程序是否执行此作。对于这些驱动程序,你将获取关联的设备列表。
- 红色表示驱动程序正在使用,但未与 PnP 设备关联。 若要使更改生效:
- 对于 KMDF,必须重新启动。
- 对于 UMDF,必须停止并重启所有 UMDF 主机进程。
- 绿色表示驱动程序当前未使用。 如果更改设置,更改将在下次加载驱动程序时生效。
预设选项
对于具有驱动程序特定设置(KMDF 和 UMDF 2)的驱动程序,右键单击该驱动程序名称以访问以下快速选项菜单:
- 设置为默认设置。
- 在驱动程序代码中启用 WDF 断点和 VERIFY 宏。
- 启用所有建议的测试设置(验证程序打开、详细和更大的 IFR 缓冲区、下层验证)。
如果更改了驱动程序的设置,但尚未提交更改,那么在驱动程序名称后显示 \ , 菜单包含一个撤消更改的其他选项。
更改驱动程序的单个验证设置
单击颜色图标左侧的 +,查看驱动程序的当前验证设置。 可以右键单击各个选项以更改它们。
右键单击布尔设置会将其切换。 某些设置提供有效选项的列表,而另一些设置则提供可在其中键入值的编辑控件。 如果输入了无效值,应用会发出蜂鸣声。 按 Enter 以使用新值或单击控件外部取消更改。
必须在 AllocateFailCount 中输入十六进制值,并为 HostTimeoutSeconds 输入十进制值。
如果启用需要 KMDF 验证程序的功能,并且 验证程序开启 选项当前处于关闭状态,则该程序会将其打开。 你仍然可以手动禁用它。 在这种情况下,描述该功能的文本指示如果校验器启用时可能执行的操作。 每当设置依赖于其他设置或应用验证程序或驱动程序验证程序使用情况时,都可以查看描述设置状态的文本中的类似更改。
如果启动和停止设备或安装新驱动程序,则必须重启 WDF 验证程序以更新清单。
如果在 WDF 驱动程序 页上进行更改,你将看到这些更改反映在 使用 WDF 页面的设备上。