Microsoft KB Archive/181279

{|
 * width="100%"|

StartIO.exe Demonstrates Cancel and Cleanup Routines

 * }

Q181279

The information in this article applies to:


 * Microsoft Win32 Device Driver Kit (DDK) for Windows NT, versions 3.5, 3.51, 4.0

SUMMARY
The StartIO.exe sample driver demonstrates the functionality of CleanUp and Cancel routines in drivers that use the device object's internal queue for IRPs and StartIO routine.

MORE INFORMATION
The following file is available for download from the Microsoft Download Center:

"StartIO.exe" Release Date: Apr-1-1999

For additional information about how to download Microsoft Support files, click the article number below to view the article in the Microsoft Knowledge Base:

"Q119591 How to Obtain Microsoft Support Files from Online Services" Microsoft used the most current virus detection software available on the date of posting to scan this file for viruses. Once posted, the file is housed on secure servers that prevent any unauthorized changes to the file.

StartIO.exe contains the following files:


 * The sample driver, which is meant to demonstrate the functionality of cleanup and cancel routines in drivers that use device object's internal queue for IRPs and StartIo routine.
 * A simple test program.

This driver provides an example of a minimal driver. Neither it nor the sample programs are intended to be used in a production environment. Rather, they are intended for educative purposes and as a skeleton driver.

Building the Driver and Examples
To compile the device driver:


 * 1) Start the checked or free build environment MS-DOS box.
 * 2) Run Build. This invokes the Microsoft make routines, which produce log files called Build.wrn and Build.log. The .wrn file contains warnings that no components have been extracted from certain libraries, even if the build succeeds. If the build succeeds, the driver can be found in the %basedir%\lib\i386\free or %basedir%\lib\i386\checked directory.
 * 3) Copy the SYS file to %systemroot%\SYSTEM32\DRIVERS directory where all the Windows NT device drivers are stored.

To install the Sample driver, use the REGINI utility to create the entries listed in the .ini file.

Testing

 * 1) Restart your computer.
 * 2) Start the driver with "net start".
 * 3) Run Testapp.

Additional query words:

Keywords : kbfile kbsample

Issue type :

Technology : kbAudDeveloper kbWinDDKSearch kbWin32sSearch kbWin32DDKSearch kbWin32DDKNT350 kbWin32DDKNT351 kbWin32DDKNT400 kbWin32DDKNTSearch