## MMPM/2 Device Driver Reference

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

### Audio Adapter Installation

MMPM/2 allows installation of device drivers developed for audio adapters into the MMPM/2 audio subsystem. MMPM/2 can then use the audio adapter to play and record digital audio files. It can also play, but not record, MIDI files.

This DDK provides a generic installation program that performs the following functions:

Asks the user for any information needed to install your adapter, such as the interrupt level.

Updates the CONFIG.SYS file with your DEVICE= statements and any other necessary statements.

Updates the MMPM2.INI file so that MMPM/2 recognizes your device driver.

Copies the files needed by your adapter, such as device drivers.

The following steps provide an overview of how to use the generic audio installation program to install a device driver into the MMPM/2 audio subsystem. The \MMOS2\MMTOOLKT\SAMPLES\AUDINST subdirectory provides the generic audio installation sample files. For more information about the AUDINST files, see Source Code. More detailed information about each step is provided in the following sections.

To add an audio adapter to the MMPM/2 audio subsystem, follow these steps:

1.Create an OS/2 device driver for the audio adapter.

For information on creating an OS/2 device driver, refer to Audio Physical Device Driver Template.

2.Write a Vendor-Specific Driver Resource File.

This file is an audio resource file that describes your audio device to MMPM/2.

For more information, see Step 2. Writing a Vendor-Specific Driver.

3.Modify the CARDINFO.RC file.

This file contains specific information about the adapter. MMPM/2 uses this information to interface with the adapter.

For more information, see Step 3. Modifying the CARDINFO.RC File.

4.If necessary, create a DLL to perform actions not provided by this generic audio installation program.

This step is not necessary, unless you want to perform some action that is not provided by the generic audio installation program.

For more information, see Step 4. Creating an Audio Installation DLL.

5.Modify the AUDHELP.ITL file.

This file contains information that is presented to the user when installing your adapter.

For more information, see Step 5. Modifying the AUDHELP.ITL File.

6.Run the MAKEFILE.

This file compiles CARDINFO.RC into a resource DLL called CARDINFO.DLL. It also compiles AUDHELP.ITL into a help file called AUDHELP.HLP.

For more information, see Step 6. Running the MAKEFILE.

7.Modify the CONTROL.SCR file.

This file is the control file used by MINSTALL to determine what subsystems and devices a user can install.

For more information, see Step 7. Modifying the CONTROL.SCR File.

8.Modify the AUDFILES.SCR file.

This file lists the files the adapter uses. It tells MINSTALL which files need to be copied and into which subdirectories to place them.

For more information, see Step 8. Modifying the AUDFILES.SCR File.

9.If necessary, create a MIDI map.

This step is not necessary if the adapter uses the general MIDI specifications.

For more information, see Step 9. Creating a MIDI Map.

10.Create an installation diskette.

This diskette must contain all the files necessary to install the adapter into the MMPM/2 audio subsystem using MINSTALL.

For more information, see Step 10. Creating the Installation Diskette.

11.Install your adapter using MINSTALL.

For more information, see Step 11. Using MINSTALL to Install Your Adapter.