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
Specifies the version number in the format "dd.dd.dd" where dd represents digits.
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.
MciInstallAlias Structure

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.
MciInstallConn Structure

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
Specifies the connector index to the other driver specified in 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
Specifies the number of external strings defined in the string field.
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] [Next]