## Using Your DDK

[prev][next][parent][TOC]

### DBCS 32-Bit PMVIDEO (Merged XGA/8514/S3 Drivers)

Driver Description:

These drivers are merged 32-bit PM video device drivers that are specifically enabled for DBCS (Double-Byte Character Set) support. These drivers should be used as the base code to develop the DBCS version of the 32-bit PM video drivers.

Compilers/Assemblers Required:

         Microsoft MASM 5.1  (supplied with the DDK)
         Microsoft MASM 6.0
         Microsoft C 6.0
         Microsoft CL386      (supplied with the DDK)

Build Instructions:

1.Run the SETDBCS.CMD command file in the <drive>:\DDK\TOOLS directory, passing <drive> and DDK as parameters. This will set the path and environment variables.

    e.g., SETDBCS <drive>:\DDK

Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is DDK\ TOOLS.

2.Before the FIRST build is attempted, run (only once) the COPYC60.CMD and COPYASM6.CMD REXX command files in the DDK\TOOLS directory. These commands copy the set of needed files from your copy of the Microsoft C 6.0 compiler and the Microsoft MASM 6.0 assembler to the proper directories under the DDK base directory.

    e.g.,
      COPYASM6 <MASMdrive>:\'MASM60' <drive>:\DDK
      COPYC60 <MSCdrive>:\'MSC60' <drive>:\DDK

    Where:
         <MASMdrive> represents the Microsoft MASM 6.0 installed drive and
         'MASM60' represents the Microsoft MASM 6.0 installed directory

         <MSCdrive> represents the Microsoft C 6.0 installed drive and
         'MSC60' represents the Microsoft C 6.0 installed directory,

         <drive> represents your DDK installed drive and
         DDK represents the DDK installed directory.

3.Change the directory to DDK\DBCS\SRC\PMVIDEO\32BIT.

4.Invoke NMAKE on the resident makefile.

This builds the retail version of the XGA, 8514, and S3 PM video drivers.

5.Invoke NMAKE DEBUG on the resident makefile.

This builds the debug version of the XGA driver.

6.Invoke NMAKE 8514D on the resident makefile.

This builds the debug version of the 8514 driver.

7.Invoke NMAKE BVH on the resident makefile.

This builds the XGA Base Video Handler.

8.Invoke NMAKE RING0 on the resident makefile.

This builds the XGA Ring0 Driver.

Build Notes:

In order to build specific drivers, specify the target on the NMAKE command (for example, NMAKE BVH). You can specify "loc" as the target to count source lines of code. See the makefile for more specific information on possible build targets.

Files Created By Successful Build:

    32-Bit XGA PM Video Driver

         Retail Version:
         Directory:  \DDK\DBCS\SRC\PMVIDEO\32BIT\RETAIL\US

         o  IBMXGA32.DLL

         Debug Version:
         Directory:  \DDK\DBCS\SRC\PMVIDEO\32BIT\DEBUG\US

         o  IBMXGA32.DLL

         Dekko Version:
         Directory: \DDK\DBCS\SRC\PMVIDEO\32BIT\DEKKO\US

         o IBMXGA32.DLL

    32-Bit 8514 PM Video Driver

         Retail Version:
         Directory:  \DDK\DBCS\SRC\PMVIDEO\32BIT\8514R\US

         o  8514_32.DLL

         Debug Version:
         Directory:  \DDK\DBCS\SRC\PMVIDEO\32BIT\8514D\US

         o    8514_32.DLL

    S3 PM Video Driver

         Retail Version:
         Directory:  \DDK\DBCS\SRC\PMVIDEO\32BIT\S3RETAIL\US

         o  IBMS332.DLL

    XGA Base Video Handler

         Directory:  \DDK\DBCS\SRC\PMVIDEO\XGABVH20

         o  BVHXGA.DLL

    XGA Ring0 Driver

         Directory:  \DDK\DBCS\SRC\PMVIDEO\XGASYS20

         o  XGA.SYS