Share via

WIA Filters Test

  • 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.

Overview

It helps WIA driver developers to implement their WIA filters in accordance with Windows Driver Kit (WDK) and Windows Logo requirements.

Details

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 under test, to log output details, and do 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.

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:

Log File:

System Restart Required:

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.
  • wttlog.dll in DLL search path

Supported Software

Hardware Requirements

  • Device to be tested
  • Computer that meets the minimum software requirements
  • At least 20 GB disk space available on current partition.
  • 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 Filters Test

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

  2. Install scanner and its Windows Vista-compatible WIA driver. Scanner should be ready for scanning - paper loaded in ADF unit, film/transparency adapter ready, and so on.

  3. Copy WiaFilters.exe to a local folder.

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

Note   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

-D:<DeviceID>

For example "{6BDD1FC6-810F-11D0-BEC7-08002BE2092F}\0001". If missing, first scanner device found will be tested.

-R:<FolderPath>

Folder for the acquired images. The path should be relative to current directory. Defaults to WiaFiltersTemp.

-v:<LogDetails>

Log detail level: quiet, verbose, or debug. Defaults to quiet.

-e:<ErrorHandling>

C++ and SEH exception handling: none, filter, all. Defaults to filter (only exceptions from WIA filters are handled and logged).

-name:<deviceName>

Name of the device to be tested, either DeviceID or Devicename has to be given

 

Cautions

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

Troubleshooting

  • Recommendation: test when only the device under test is installed on test machine.

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

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

Code Tour

File Manifest

File Location

WiaFilters.exe

%controller%\tests\<arch>\nttest\PrintScanTest\WIA\wiafilters

 

 

 

Build date: 9/14/2012