Share via

WIA Data Transfer Tool

  • 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

The WIA Data Transfer tool is an automated Windows Driver Kit (WDK) tool for testing behavior of WIA minidrivers related to data transfer.

This tool verifies that a driver does not cause applications or the WIA service to crash or hang in edge conditions during data transfer. It also verifies that the correct behavior is implemented by the driver in different configurations, sequences of actions, and errors that may occur during transfer. This tool ensures that there is no ambiguity in driver's behavior in these scenarios and hence guarantees compatibility between all WIA drivers and WIA applications.

Details

The WIA Data Transfer tool runs either from the WDK or standalone from the command line. It logs results to the console and to a WTT log file, and can be configured to log at two different levels of verbosity. By default, it runs all test cases but individual test cases can be specified as well.

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: DataTransfer.wtl

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
  • 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 Data Transfer Tool

To set up this tool manually, follow these steps:

  1. Install the WIA device to be tested.

  2. Register WiaTestLog.dll using RegSvr32.

  3. Run the WiaTransferTool.

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

WiaTransferTool.exe

[/help]

Optional; List available command-line options.

[/log:<logfilename>]

Optional; Default is "DataTransfer.wtl".

[verboselog:<0 or 1>]

Optional; Specifies the level of verbosity. Default is "1".

device:<deviceID of device 1>

Required; Four-digit device ID of WIA device to test.

[/device2:<deviceID of device 2>]

Optional; Run all test cases, including those requiring two devices. Test will not log a pass unless all tests are run.

[/case:<case number>]

Optional, for debugging purposes; Run only specified test case. Test will not log a pass unless all tests are run.

 

Troubleshooting

Use with command-line option /verboselog:1. Detailed logging goes into WTT log file.

Code Tour

File Manifest

File Location

WiaTransferTool.exe

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

wiatestlog.dll

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

 

 

 

Build date: 9/14/2012