This directory contains samples and test tools for Windows Image Acquisition (WIA), a driver architecture and user interface for acquiring images from still image devices such as scanners and digital still cameras. This architecture is currently only supported by Windows Me and Windows XP. These samples will not run on Windows 2000, Windows 98, or Windows 95.
The following lists the WIA components and samples in the DDK:
Documentation on WIA can be found in the Platform SDK and this DDK. The DDK contains information on developing drivers, and the Platform SDK contains information for application writers. Note that WIA properties are only documented in the Platform SDK under the topic Windows Image Acquisition/Wia References/WIA Application Programming Interface/Constants/WIA Property Constants.
Each sample directory contains brief documentation on how to build and run that sample.
The Wiascanr directory contains a sample WIA minidriver for a flat-bed scanner with a document feeder. See the documentation file Wiascanr.htm in the Wiascanr directory for more information. (This sample replaces the old sample, Wiatscan.)
The Microdrv directory contains a sample WIA microdriver for a scanner. A microdriver is much easier to develop than a full WIA minidriver, but provides only basic functionality. See the documentation file Testmcro.htm in the Microdrv directory for more information.
The Wiacam and Microcam directories contain a sample WIA driver for a digital still camera and the Extend directory contains a sample user interface extension. See the documentation file Wiacam.htm in the Wiacam directory, Fakecam.htm in the Microcam directory, and Extend.htm in the Extend directory for more information.
The Tools\Wia directory in the root directory of the DDK contains additional tools to help with WIA driver development. Documentation for the tools is contained in the DDK documentation.
To quickly build and test all of the samples, run the “build” command in the src\wdm\wia directory using the Free or Checked DDK Build Environment. Then run the “copywia.cmd” batch file to gather all of the binaries into a subdirectory named “wiabins”. The camera and scanner samples can be installed in Windows Me or Windows XP by using the “Add Device” icon in the Scanners and Cameras control panel. Use the “Have Disk” button to point to the wiabins\drivers folder. Wiatest.exe (from the DDK Tools\Wia directory), MS Paint, the Scanner and Camera Wizard or any TWAIN application (through the WIA TWAIN compatibility layer) can be used to test the samples.
For more information on building and using the samples, see the individual documentation files referenced above.
WIA information: http://www.microsoft.com/hwdev/tech/wia
DDK information: http://www.microsoft.com/ddk/