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。
测试详细信息
规范 |
|
平台 |
|
支持的版本 |
|
预计运行时间(以分钟为单位) | 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 测试可能会失败。 若要解决此问题,请执行以下操作:
重新启动 DTM 客户端并等待其登录。
关闭设备控制台。
重新打开提交。
这将确保收集器数据同步并填充友好名称。
如果上述步骤不起作用,请与你的驱动程序开发人员一起确保 INF 正确引用驱动程序。
参数
参数名称 | 参数说明 |
---|---|
LLU_LclAdmin.DomUsr | LLU_LclAdmin.DomUsr |
LLU_NetAccessOnly | LLU_NetAccessOnly |