WIA 属性测试

此自动化测试使用 Windows 图像采集 (WIA) 测试工具来验证是否根据 Windows 驱动程序工具包 (WDK) 和 Windows Vista 徽标要求实现了 Vista 之前的样式驱动程序的所有 WIA 属性。 此自动化测试还验证由 Vista 之前的扫描仪驱动程序生成的 WIA 项目树的结构是否正确。

此测试将帮助驱动程序开发人员检测属性错误和项目树实现错误。

注意

   Windows 8、Windows 7、Windows Server 2008 R2 和 Windows Server 2012 中要求通过 WIA 2.0 测试。 Windows Vista 不要求通过 WIA 2.0。

 

测试详细信息

   
规范
  • Device.Imaging.Scanner.Base.wia20
  • Device.Imaging.Scanner.Base.dataTransfer
  • Device.Imaging.Scanner.Base.WIAProperties
平台
  • Windows 10,客户端版本 (x86)
  • Windows 10,客户端版本 (x64)
  • Windows Server 2016 (x64)
  • Windows 10,客户端版本 (Arm64)
支持的版本
  • Windows 10
  • Windows 10 版本 1511
  • Windows 10 版本 1607
  • Windows 10 版本 1703
  • Windows 10 版本 1709
  • Windows 10 版本 1803
  • Windows 10 版本 1809
  • Windows 10 版本 1903
  • Windows 10 的下一次更新
预计运行时间(以分钟为单位) 2
类别 兼容性
超时(以分钟为单位) 120
需要重启 false
需要特殊配置 false
类型 automatic

 

其他文档

此功能区域中的测试可能会有其他文档,包括先决条件、设置和故障排除信息,这些内容可在以下主题中找到:

运行测试

在运行测试之前,请按照如下测试要求中所述完成测试设置:扫描程序测试先决条件

如果你的设备支持自动送纸,则此测试要求满足以下条件:

  • 进纸器中有足够的纸张(通常约为 50 页)。

故障排除

有关 HLK 测试失败的常规故障排除,请参阅排查 Windows HLK 测试失败问题

有关故障排除信息,请参阅排查 Device.Imaging 测试问题

如果在大型日志文件的中间某处报告失败,请尝试确定是哪个测试脚本导致了失败。 然后单独运行此脚本,而不将其与其他测试一起运行。 例如:

WiaTreeProperties.exe -r scripts\DPA\DPA_DEVICE_TIME.wia -debug -w

如果测试崩溃,请尝试在调试器下从命令提示符运行 WiaTreeProperties.exe 以确定崩溃的原因。

仅当测试失败且 Microsoft 支持服务部门要求你使用 UseDebugLogs 参数时,才应使用此参数。

更多信息

此工具使用 XML 文件和测试脚本中存储的信息来验证 WIA 属性的正确实施。 Windows SDK 和 WDK 文档中定义的每个 WIA 属性都具有以下属性:

  • 数据类型

  • 访问类型

  • 必需项

  • 可选项

  • 合法值(列表或范围)

  • 对其他属性的依赖

该工具包含一个测试应用程序、一个列出所有属性的 XML 文件和每个属性一个测试脚本。 测试应用程序允许通过命令行参数指定一个测试属性或一组属性,读取属性测试脚本和 XML 数据,并将结果与 WIA 驱动程序中的属性实现进行比较。 如果预期的属性属性和实现的属性属性不匹配,则测试失败。 如果所有测试的属性都按照 WDK 要求实现,则测试成功。

此工具包括:

  • 控制台测试应用程序 WiaTreeProperties.exe - 支持多个命令行参数。 控制台测试应用程序还将测试信息导出到 WTT 日志文件、控制台和自定义日志窗口(可选)。

  • GUI 应用程序 WiaTreePropertiesGUI.exe - 通过 UI 收集测试参数并运行 WiaTreeProperties.exe 以执行测试。

  • WiaTestLog.exe - 自定义日志窗口,可用于显示测试输出。 请参阅 -w 命令开关。

  • WiaPropDB.dll - 用于读取 WIA 属性的托管程序集。 XML 数据库存储在 WiaTreeProp.xml 文件中

  • *.wis 文件 - 测试套件(测试脚本组)

  • *.wia 文件 - WiaTreeProperties.exe 应用程序使用的测试脚本

运行 WIA 树属性测试

如果你不使用 WIA 友好名称,则 WIA 测试可能会失败。 若要解决此问题,请执行以下操作:

  1. 重新启动 DTM 客户端并等待其登录。

  2. 关闭设备控制台。

  3. 重新打开提交。

这将确保收集器数据同步并填充友好名称。

如果上述步骤不起作用,请与你的驱动程序开发人员一起确保 INF 正确引用驱动程序。

参数

参数名称 参数说明
LLU_LclAdmin.DomUsr LLU_LclAdmin.DomUsr
LLU_NetAccessOnly LLU_NetAccessOnly