Sample WIA Camera Microdriver

[This is preliminary documentation and subject to change.]

SUMMARY

This sample shows how to write a Windows Image Acquisition (WIA) user-mode microdriver for a camera. It simulates a camera by reading images from a directory on the hard disk. This sample driver can be used as a starting point for your development, but your driver should access the camera hardware through one of the kernel drivers provided with Windows.

This sample is implemented in 3 parts. This is part is the microdriver. The “Wiacam” sample implements the WIA minidriver that calls this driver. The third part is the sample UI extension “Extend.”

At the time of this writing, WIA is only supported on Windows Me and Windows XP. This sample will not work on Windows 98 or Windows 2000.

BUILDING THE SAMPLE

To build the sample follow these steps:

1. In the Start menu, select "Free Build Environment" or "Checked Build Environment" under "Windows DDK" to open a command window and set basic environment variables needed to build drivers.

2. Change to the directory containing the sample driver source code, src\wdm\wia\microcam.

3. Execute the "build" command. After the build completes, a driver named Fakecam.dll will be located in an object subdirectory.

4. Also build the minidriver in src\wdm\wia\wiacam and the user interface extension located in the src\wdm\wia\extend directory.

USING THE SAMPLE

To use the driver, first install it following these steps:

1. Copy Fakecam.dll from the appropriate object subdirectory under Fakecam to a new, empty directory.
2. Do the same with Extend.dll and Wiacam.dll.
3. Copy Wiacam.inf to the same directory.
4. Copy Tcamlogo.jpg and Testcam.ico from the Extend directory to the same directory.
5. In Windows Me or Windows XP, open the “New Device” icon in the Scanners and Cameras control panel.
6. Click the “Have Disk” button and enter the name of the folder created in step 1.
7. Click OK, Next, or Finish until the wizard is finished.

Use one of these options to test this driver:

1. The Scanners and Cameras Wizard accessible from the Start menu.

2. The Namespace extension accessible by opening the camera in Explorer.

3. The Wiatest application provided in this DDK.

4. Microsoft Paint, a native WIA application.

5. Any TWAIN compliant application.

RESOURCES

WIA information: http://www.microsoft.com/hwdev/tech/wia

DDK information: http://www.microsoft.com/ddk/

CODE TOUR

File Manifest

Files Description
------------ -------------------------------------------------------
FakeCam.cpp Implements the camera microdriver
fakecam.def Linker command file
FakeCam.h Header for camera microdriver
fakecam.htm This readme
fakecam.rc Main resource file
fakecam.rcv Additional resource definitions
makefile Used for building the driver--do not modify
pch.h Precompiled header
resource.h Header file for resources
sources Controls building of driver
 

Programming Tour

To be provided in a later release.