STI Test Application

[This is preliminary documentation and subject to change.]

SUMMARY

This sample is an application that can be used to test a Still Image (STI) user-mode minidriver. It can also be used as sample code for an STI-aware application or TWAIN data source.

BUILDING THE SAMPLE

To build the sample, open a DDK command window, change to the App directory, and use the build command. Before you can use the sample, you need to install an STI device or the Sample User-mode Minidriver, Sampusd. Any device that appears in the Scanners and Cameras control panel is an STI device.

This sample has been tested on Alpha platforms. It has not been confirmed to be 64-bit compliant. The code builds properly with Visual C 6.0. Plug and Play and Power Management do not apply to this sample.

Building this sample produces one file: Stillvue.exe. Both free and checked versions are buildable. The sample has been tested with a binary that was built with Visual C 5.0.

TOOLS

The Stillvue app can be run from a debugger or on its own. When the application is run, it presents several menu choices. Each menu choice corresponds to an STI function call. The functions should be executed in the same order as an application or TWAIN data source would call them. For example, the first thing to do is to call IStillImage::StiCreateInstance by selecting menu item IStillImage, StiCreateInstance. Next select IStillImage, GetDeviceList, and select a device with IStillImage, CreateDevice. Other functions can be selected as needed for your testing requirements.

RESOURCES

More information on TWAIN can be found at http://www.twain.org.

To get a logo for your device, consult WHQL for information and test suites.

Your device should support Plug and Play, even if it uses the parallel or serial port. Download Plug and Play specs from their Web site.

CODE TOUR

File Manifest

File			Description

App.htm	      		The documentation for this sample (this file)
Stillvue.cpp	 	Implements application
Stisvc.cpp	   	Generic implementation of scanning functions
Winx.cpp	     	Implements utility functions
Wsti.cpp	     	Implements calls to each of the STI functions
Stillvue.h	   	Main application header file
Stivar.h	     	Global STI variable declarations
Winx.h	       		Utility function header
Resource.h	   	Resource header
Stillvue.rc	  	Resource file
Scan1.ico	    	Application icon
Makefile	     	The makefile for the project; do not edit.
Sources	      		DDK build instructions

Programming Tour

Each of the STI functions called by the Stillvue application is documented in the DDK documentation under Still Image Interfaces, IStiUSD Interface.

Top of page

© 1999 Microsoft Corporation