## Using Your DDK

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

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

Driver Description:

The PMVIDEO Device Driver is a merged 32-bit video device driver for XGA, 8514, and S3 chip set adapter cards. It builds the 32-bit PM display driver in three different flavors for use with the XGA adapter, the 8514/A adapter , and the S3 chip set.

The PMVIDEO display driver takes advantage of the hardware acceleration capabilities of the chip sets described in the S3 data books 86C801/86C805 GUI Accelerators. It conforms to the OS/2 32-bit flat memory model and is designed to function as a 32-bit PM display driver under the OS/2 32-bit graphics engine subsystem.

The PMVIDEO component includes XGA Base Video Handler and XGA Ring0 device driver source code, in addition to PM display drivers.

New source code to support PM Video Acceleration is included in the PMVIDEO component. It provides a mechanism for MMPM/2 software to take advantage of the latest set of video hardware acceleration. The following new drivers have been added:

S3 PM Display Driver

Enhanced to support additional DEVESCs.

PM Video Accelerator Device Driver Sample

Called by PM display driver; communicates with the video accelerator HW directly. It is a template code.

Compilers/Assemblers Required:

         Microsoft MASM 5.1  (supplied with the DDK)
         Microsoft C 6.0
         Microsoft CL386     (supplied with the DDK)
         IBM C Set ++ V2.01

Build Instructions:

1.Ensure the necessary compilers and assemblers are installed.

2.Run the SETCMPLR.CMD REXX command file located in the DDK\TOOLS directory. This command initializes environment variables to be used during the build.

e.g., SETCMPLR <MSCpath> <VACpath> <CSETpath> <DDKpath>

    Where <MSCpath> represents the Microsoft C 6.0 install directory
           <VACpath> represents the IBM Visual Age C++ install directory
           <CSETpath> represents the IBM C Set ++ install directory
           <DDKpath> represents the DDK install directory

Note: A period (.) may be substituted for a compiler directory that is not used during the build.

To build the XGA, 8514, S3, XGA Base Video Handler, and XGA Ring0 drivers:

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

4.To build the retail version, invoke NMAKE with target RETOS2C on the resident makefile.

5.To build the debug version, invoke NMAKE with target DBGOS2C on the resident makefile.

6.To build the dekko version, invoke NMAKE with target PROOS2C on the resident makefile.

To build the S3 PM Display Driver that supports PM Video Acceleration:

7.Change the directory to \DDK\VIDEO\SRC\VIDEO\PMVIDEO\S3TIGER.

8.To build the retail version, invoke NMAKE with target RETOS2C on the resident makefile.

9.To build the debug version, invoke NMAKE with target DBGOS2C on the resident makefile.

To build the PM Video Acceleration driver:

10.Change the directory to \DDK\VIDEO\SRC\VIDEO\PMVIDEO\PMACCEL.

11.Invoke NMAKE on the resident makefile.

Build Notes:

In order to build specific drivers, specify the target on the NMAKE command (for example, NMAKE 8514). 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

         Retail Version:
         Directory:  \DDK\VIDEO\REL\OS2C\RETAIL\BASE\OS2\DLL

         o  IBMXGA32.DLL

         Debug Version:
         Directory:  \DDK\VIDEO\REL\OS2C\DEBUG\BASE\OS2\DLL

         o  IBMXGA32.DLL

         Dekko Version:
         Directory: \DDK\VIDEO\REL\OS2C\PROFILE\BASE\OS2\DLL

         o  IBMXGA32.DLL

    32-Bit 8514

         Retail Version:
         Directory:  \DDK\VIDEO\REL\OS2C\RETAIL\BASE\OS2\DLL

         o  8514_32.DLL

         Debug Version:
         Directory:  \DDK\VIDEO\REL\OS2C\DEBUG\BASE\OS2\DLL

         o  8514_32.DLL

         Dekko Version:
         Directory:  \DDK\VIDEO\REL\OS2C\PROFILE\BASE\OS2\DLL

         o  8514_32.DLL

    32-Bit S3 Chip Set Support

         Retail Version:
         Directory:  \DDK\VIDEO\REL\OS2C\RETAIL\BASE\OS2\DLL

         o  IBMS332.DLL

         Debug Version:
         Directory:  \DDK\VIDEO\REL\OS2C\DEBUG\BASE\OS2\DLL

         o  IBMS332.DLL

         Dekko Version:
         Directory:  \DDK\VIDEO\REL\OS2C\PROFILE\BASE\OS2\DLL

         o  IBMS332.DLL

    XGA Base Video Handler

         Directory:  \DDK\VIDEO\REL\OS2C\RETAIL\BASE\OS2\DLL

         o  BVHXGA.DLL

    XGA Ring0 Device Driver

         Directory:  \DDK\VIDEO\REL\OS2C\RETAIL\BASE\OS2\BOOT

         o  XGA.SYS

    S3 PM Display Driver supporting PM Video Acceleration

         Retail Version:
         Directory:  \DDK\VIDEO\REL\OS2C\RETAIL\BASE\OS2\DLL

         o  S3TIG32.DLL

         Debug Version:
         Directory:  \DDK\VIDEO\REL\OS2C\DEBUG\BASE\OS2\DLL

         o  S3TIG32.DLL

    PM Video Accelerator Device Driver Sample

         Directory:  \DDK\VIDEO\REL\OS2C\RETAIL\BASE\OS2\DLL

         o  TEMPLATE.DLL