WIA Filters

  • Article

This automated test helps Windows® Image Acquisition (WIA) driver developers to implement their WIA filters in accordance with Windows Driver Kit (WDK) and Windows Certification requirements.

Note  

WIA 2.0 is a requirement for the test to pass in Windows 7, Windows 8, Windows Server 2008, and Windows Server 2012. WIA 2.0 is not a requirement for Windows Vista.

 

The test consists of a single executable, which uses wttlog.dll to write test results to the console and to a WTT log file (WiaFilters.wtl) in the current directory. Command-line parameters can be used to specify the device that is being tested, to log output details, and to perform error handling. All parameters are optional. If a device ID is not specified at the command line, the first installed WIA device with a Windows Vista-compatible driver will be selected for testing.

Test details

Associated requirements

Device.Imaging.Scanner.Base.wia20

See the device hardware requirements.

Platforms

Windows 7 (x64) Windows 7 (x86) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows Server 2008 R2 (x64) Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2

Expected run time

~2 minutes

Categories

Certification Functional

Type

Automated

 

Running the test

Before you run the test, complete the test setup as described in the test requirements: Scanner Testing Prerequisites.

Before running this test the Wdk\ConfigureScanner dimension must be added to the machine pool. To do add the dimension to the machine pool, complete the following:

  1. From the Windows HCK Studio, open the Job Monitor.

  2. Select the computer pool containing test computer that the test scanner is attached to.

  3. Right-click the computer pool to open the properties page, and then select the MCU Policy tab.

  4. From the available dimension list select Wdk\ConfigureScanner, add it to the machine pool and then click Ok.

In addition, if your device supports automatic document feeding, this test requires the following:

  • Enough paper in the feeder (usually about 50 pages).

Troubleshooting

For troubleshooting information, see Troubleshooting Device.Imaging Testing

Note  

To enable logging, wttlog.dll must be in the DLL search path.

 

For test failures, search for the term “+sev” in the log.

Test specific troubleshooting details

When running this test, be advised of the following:

  • Test when only the device being tested is installed on the test machine.

  • Use debug logging (-v:debug) if quiet logging output does not provide enough information.

  • Run the test under a debugger and trace the calls into filters code.

  • WIA tests may fail if you do not use the WIA friendly name. To resolve this, follow these steps:

    1. Restart the Windows HCK client and wait for it to log in.

    2. Close the Device Console.

    3. Re-open the submission.

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

    Note  

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

     

Warning  

Do not run any other scanning applications while you are running the test. Do not install/uninstall imaging devices while you are running the test.

 

More information

To run this test manually, follow these steps:

  1. Install Windows Vista and wttlog.dll in DLL search path.

  2. Install the scanner and its Windows Vista-compatible WIA driver.

  3. Verify the scanner is ready to scan. This includes the following:

    • Paper loaded in ADF unit

    • Film/transparency adapter ready

  4. Copy WiaFilters.exe to a local folder.

  5. Run WiaFilters.exe and look at console output and generated WiaFilters.wtl file for test results.

 

 

Send comments about this topic to Microsoft