Installing a Media Control Driver

To install a media control driver (MCD) in the OS/2 multimedia system:

• Create an INI change control file containing the information needed for the media control driver. This will make the necessary changes in the MMPM2.INI file.

  When you create a new MCD, you have to install drivers into the OS/2 multimedia system to use the new MCD. The following is an example of how to use structures in an INI Change Control File to install a Sound Blaster Waveform Audio Driver that uses a new Audio MCD named "MyNewMCD." See Defining Changes to the MMPM2.INI File for a detailed description of these structures.

  MciInstallDrv =
      (
      DrvInstallName     = "MyWaveSB01"
      DrvDeviceType      = 7
      DrvDeviceFlag      = 01L
      DrvVersionNumber   = "1"
      DrvProductInfo     = "Sound Blaster Pro MCV"
      DrvMCDDriver       = "MyNewMCD"
      DrvVSDDriver       = "Audioif"
      DrvPDDName         = "SBAUD1$"
      DrvMCDTable        = "MDM"
      DrvVSDTable        = ""
      DrvShareType       = 3
      DrvResourceName    = "SoundblasterW01"
      DrvResourceUnits   = 1
      DrvClassArray[1]  =
           (
                ( DrvClassNumber = 1 )
           )
      )
  MciInstallParm =
      (
      ParmInstallName   = "MyWaveSB01"
      ParmString        = "FORMAT=1,SAMPRATE=22050,BPS=8,CHANNELS=2,
                          DIRECTION=PLAY"
      )
  
  
  MciInstallConn =
      (
      ConnInstallName="MyWaveSB01"
      ConnArray[1]=
           (
              (
              ConnType=3                   /* Wavestream connector */
              ConnInstallTo="MyAmpMixSB01" /* Connect to ampmixer  */
              ConnIndexTo=1                /* First connector in
                                              ampmixer             */
              )
           )
      )
  
  
  MciInstallAlias =
      (
      AliasInstallName="MyWaveSB01"
      AliasString="Wave Audio"
      )
  
  
  MciInstallExt =
      (
      ExtInstallName = "MyWaveSB01"
      ExtArray[1] =
         (
            (ExtString = "WAV")
         )
      )
  

• Install external settings pages in the Multimedia Setup notebook (optional). See Inserting External Settings Pages.

• Specify the name of your INI change control file in an SSINICH keyword in the master control file (CONTROL.SCR). See CONTROL.SCR Subsystem Definition for more information. An example of a CONTROL.SCR file and a description of the keywords are provided in that section. For example:

  SSINICH="MYMCD.SCR"
  

You might want to experiment with the sample files provided in the \TOOLKIT\SAMPLES\MM\CF subdirectory. If you decide to experiment with the MCD templates provided in the toolkit, you can test your changes by replacing the name of the driver that comes with OS/2 multimedia with the name of your driver. For example, you can edit the MMPM2.INI file and change the MCDDRIVER=AUDIOMCD statement to MCDDRIVER=AUDIOMCT. You also must copy your MCD to a directory that is included in the LIBPATH statement of your CONFIG.SYS file (for example, \MMOS2\DLL). After you make these changes and restart your system, OS/2 multimedia will use your MCD instead of the OS/2 multimedia MCD.

Note: After you complete your MCD testing, you must change the MMPM2.INI text file back to its original state. Unpredictable results can occur when OS/2 multimedia is used without its supported MCDs.