Defining Changes to the MMPM2.INI File

Some multimedia subsystems require unique information in the MMPM2.INI file. This file is used by the media device manager (MDM) to maintain a database of installed multimedia components and devices.

The following structures are used to make changes to the MMPM2.INI file.
MciInstallDrv Structure

The MciInstallDrv structure shown in the following example allows you to install MCDs on your system.

MciInstallDrv =
    (
    DrvInstallName   = "internalname"
    DrvDeviceType    =  devicetypecode
    DrvDeviceFlag    =  deviceflag
    DrvVersionNumber = "verno"
    DrvProductInfo   = "name2"
    DrvMCDDriver     = "mcdname"
    DrvVSDDriver     = "vsdname"
    DrvPDDName       = "pddname"
    DrvMCDTable      = "mcdtablename"
    DrvVSDTable      = "vsdtablename"
    DrvShareType     = number1
    DrvResourceName  = "resname"
    DrvResourceUnits = number2
    DrvClassArray[num] =
           (
                (DrvClassNumber = number3)
           )
    )

internalname

Specifies the name under which the device is being installed. This must be a unique name. Consider using a name that is a combination of a company name, device type, and device model. For example, the IBM media driver for the Sound Blaster waveaudio device is ibmwavesb01.

devicetypecode

Specifies an encoding of the device type. These codes are defined in the MCIOS2.H file located in the \TOOLKIT\H subdirectory.

deviceflag

Specifies the LONG INT with the flags set. This determines whether or not the device is controllable.

verno

dd.dd.dd

name2

Specifies the full name of the product and can be translated.

mcdname

Specifies the name of the DLL that contains the media control driver (MCD). This driver is loaded by the media device manager (MDM).

vsdname

Specifies the name of the DLL that contains the vendor-specific driver (VSD) used by the MCD (if any).

pddname

Specifies the name of the physical device driver used by the MCD (if any).

mcdtablename

Specifies the name of the DLL containing the MCD command table. (OS/2 multimedia provides a standard command table.)

vsdtablename

Specifies the name of the DLL containing the VSD command table.

number1

Specifies an encoding of the valid types of sharing supported. These codes are defined in the MMDRVOS2.H file located in the \TOOLKIT\H subdirectory.

resname

Specifies a unique name for the management of the driver resources.

number2

Specifies the maximum number of resource units supported for the driver.

num

Specifies the number of resource classes defined in the next field.

number3

Specifies the maximum number of resource units used by the class.

The MciInstallAlias structure shown in the following example allows you to specify an alternate name for a driver installed on your system.

MciInstallAlias =
    (
    AliasInstallName = "internalname"
    AliasString      = "aliasstring"
    )

internalname

Specifies the internal name of the driver with which the alias is associated. This name is specified in the MciInstallDrv structure.

aliasstring

Specifies an alternate name of the driver.

Each implementation of a media driver defines certain paths of information flow into and out of the device. These paths are known as connectors. Connectors have defined connector types, and each connector type has an associated connector-type name. The MciInstallConn structure shown in the following example allows you to install the media connectors on your system.

MciInstallConn =
    (
    ConnInstallName = "internalname"
    ConnArray [num1]
         (
              (
              ConnType      = num2
              ConnInstallTo = "connto"
              ConnIndexTo   = num3
              )
         )
    )

internalname

Specifies the internal name of the driver with which the connector is associated. This name is specified in the MciInstallDrv structure.

num1

Specifies the number of entries in the array.

num2

Specifies the connection type. Connection types are defined in the MCIOS2.H file located in the \TOOLKIT\H subdirectory.

connto

Specifies the internal name of the driver to connect to.

num3

connto

MciInstallExt Structure

When an element name is specified as the device name on an MCI_OPEN message and no device type is specified, the device type is identified by the file extension. For example, if the .WAV extension is associated with an internal driver name, that driver will be used if a file ending in .WAV is opened.

The MciInstallExt structure shown below allows you to define media control interface file extensions on your system.

MciInstallExt =    (
    ExtInstallName = "internalname"
    ExtArray[num]  =
         (
         (ExtString = "string")
         )
    )

internalname

Specifies the internal name of the driver with which the extension is associated. This name is specified in the MciInstallDrv structure.

num

string

Specifies the valid extensions.

MciInstallParm Structure

The MciInstallParm structure shown below allows you to define device-specific parameters that provide additional information about the driver to your MCD. For example, this structure is used to define to the MIDI MCD which MIDI map table to use for each sequencer.

MciInstallParm =   (
   ParmInstallName = "internalname"
   ParmString      = "device specific parameters"
   )

internalname

Specifies the internal name of the driver with which the parameters are associated. This name is specified in the MciInstallDrv structure.

device specific parameters

Specifies the parameters needed by the driver. These parameters can be used to provide additional information about the driver.

[Back: Defining a Program in a Folder on the Desktop]

[Next: Defining Changes to Other INI Files]