VxD Include Files: Used for Building Virtual Devices

These include files are needed for building virtual devices (VxDs). Use them in conjunction with the VxD tools (see the “VxD Tools” abstract).

Copy these include files to your hard drive in a subdirectory of your choice. When deciding on a directory location, keep in mind that some VxD sample code assumes that the INCLUDE directory is adjacent to the sample code subdirectories, as shown below:

Parent Directory
|

+------------------+------------------+
| | |
Sample1 Sample2 Include
1.asm 2.asm vmm.inc
1.inc 2.inc v86mmgr.inc
... ... ...

The make files for the VxD samples assume this directory structure; for example:

vxdstub.obj: vxdstub.asm
masm -I..\include vxdstub;

When building a sample that uses this convention, you must do one of the following:

Structure your directories according to the assumption described above;

Modify the make file by changing the MASM -I option to point at the directory location you have chosen for the include file;

Declare a new MS-DOS(R) environment variable such as VXDINCLUDE and point it at the VxD include files. Then modify the make file so the MASM -I option uses the environment variable as a macro. For example:

masm -I$(VXDINCLUDE) vxdstub;

Set the MS-DOS INCLUDE environment variable to point to the VxD include files. Then remove the MASM -I option and let MASM find the INCLUDE directory based on the MS-DOS INCLUDE environment variable. This method uses the same environment variable (INCLUDE) for both the Software Development Kit (SDK) and the Device Driver Kit (DDK). Because some include files are duplicated in both the SDK and the DDK, this method results in potential ambiguity. The three previous methods do not have this problem.

For more information on using the Microsoft(R) Windows(TM) version 3.1 DDK files included on this CD, read the technical article "The VxD-Lite Mini-DDK." For more information on virtual device programming, see the DDK "Virtual Device Adaptation Guide."

{ewc navigate.dll, ewbutton, /Bcodeview /T"Click to open or copy files in the vxdinc project." /C"samples}