Share via

WIA Tester

  • Article

Note  This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.

Type: Automated Test

Overview

This test tool verifies that all WIA properties for pre-Vista style drivers are implemented according to the Windows Driver Kit (WDK) and Windows Vista Logo requirements. It also verifies the correct structure of the WIA item tree built by a pre-Vista scanner driver.

This test should help driver developers to detect properties and item tree implementation errors.

Details

This tool uses information stored in an XML file and test scripts to verify correct implementation of WIA properties. Each WIA property defined in Windows SDK and WDK documentation has the following attributes: data type, access type, required items, optional items, legal values (list or range), and dependencies on other properties. The tool consists of a test application, an XML file listing all properties, and one test script per property. The test application allows a tested property or set of properties to be specified through command line parameters, reads property test script(s) and XML data, and compares the results to the property implementation in a WIA driver. The test fails if the expected property attributes and implemented property attributes do not match. The test succeeds if all tested properties are implemented according to WDK requirements.

Tool components:

  • Console test application WIATester.exe - supports multiple command line parameters, exports test information to a WTT log file, console and custom log window (optional).

  • GUI application WiaTestGui.exe - collects test parameters through the user interface and runs WiaTreeProperties.exe to do the actual testing.

  • WiaTestLog.exe - custom log window; can be used for displaying test output. See -w command switch.

  • WiaPropDB.dll - managed assembly for reading WIA properties; XML database stored in WiaTreeProp.xml file.

  • *.wis files - test suites (groups of test scripts).

  • *.wia files - test scripts, used by the WIATester.exe application.

WIA 2.0 is a requirement for the test to pass in Windows 7 and Windows 2008 R2. WIA 2.0 is not a requirement for Windows Vista.

Run Time: 20 mins

Log File:

System Restart Required: No

Test Category:

Supported operating systems for Logo or Signature testing:

  • Windows 7

  • Windows Server 2008

  • Windows Server 2008 R2

  • Windows Vista

Program:

Requirements

Software Requirements

The test tool runs on the following Windows operating systems:

  • Supported operating system (see list above).
  • Software components included with the device that is being tested.

Supported Software

Hardware Requirements

  • Device to be tested
  • Computer that meets the minimum software requirements
  • Windows keyboard
  • Two-button pointing device
  • Hard drive with a minimum of 20 GB available on partition C:
  • If your device supports automatic document feeder, make sure there is enough paper in the feeder (usually about 50 pages).

Processor

  • x86
  • x64

Running WIA Tester

WIA tests may fail if you do not use the WIA Friendly name, To resolve this, please follow these steps:

  1. Restart the DTM Client and wait for it to log in.

  2. Close the Device Console.

  3. Re-open the submission.

This will ensue that the gatherer data is in-sync and that the friendly name is populated.

If the steps above do not work, please work with your driver developer to make sure that the INF is referencing the driver correctly.

Command Syntax

Command option Description

-r <TestSuiteOrScript>

Which test script or suite to run.Required parameter.

-D <WiaDeviceID>

Which device to test. Default: First WIA device with Windows Vista compatible driver.

-q, -v, -debug

Log details level - quiet, verbose, debug. Default: quiet.

-I <TestRuns>

How many times to run each test. Default: 1.

-p

Prompt user between test iterations.

-w

Display custom log window.

-R <Folder>

Specify which folder to use for images acquired during test. Default: Images

-x <XmlFileName>

Which XML file contains WIA Properties database. Default: WiaTreeProp.xml

 

Cautions

Do not install or uninstall imaging devices during test. Do not run any imaging applications during test execution

Code Tour

File Manifest

File Location

scripts folder (recursively)

%controller%\tests\<arch>\nttest\PrintScanTest\WIA\LDK\wiatester\scripts

All WIS, WSF, XSD, XML files

%sdxroot%\testsrc\printscantestdata\REDIST\wia\ldk\WiaTester\

All EXE, DLL files

%sdxroot%\testsrc\printscantestdata\REDIST\wia\ldk\WiaTester\

 

 

 

Build date: 9/14/2012