Miles Sound System SDK 7.2a

AIL_install_MDI_driver_file

The function AIL_install_MDI_driver_file installs and initializes an MSS-compatible .MDI driver file for XMIDI music performance under DOS.

HMDIDRIVER AIL_install_MDI_driver_file(
  char const * filename,
  IO_PARMS * const *IO
);

In Parameters

filename: specifies the filename, including path, of the driver to install.
IO: specifies a particular I/O configuration to use when initializing the driver. If *IO is NULL or if the device cannot be detected using the specified parameters, the function will attempt to auto-detect the supported device using DOS environment strings or other driver-specific techniques.

Returns

A pointer to a dynamically allocated structure of type MDI_DRIVER, which may be passed by the application to subsequent function calls involving the driver; or NULL if an error occurs.

Discussion

For compatibility with other Miles platforms, you should use the AIL_open_XMIDI_driver function instead of this DOS-only function.

Do not embed the .MDI files in any type of proprietary library file. You can leave them on your CD-ROM, if you use the AIL_set_redist_directory function to specify their location.

RAD Game Tools strongly recommends use of the SETSOUND utility to create .INI files describing the user's driver choices and configurations. MSS applications may then use the AIL_install_DIG_INI and AIL_install_MDI_INI functions instead of calling AIL_install_DIG_driver_file or AIL_install_MDI_driver_file directly.

You can use the AIL_set_redist_directory function to specify an alternate path to load the .MDI driver from (if the load fails from the current directory).

This function must not be invoked from an interrupt-based callback function.

Group: XMIDI Services
Related Functions: AIL_close_XMIDI_driver, AIL_get_IO_environment, AIL_install_DIG_INI, AIL_install_DIG_driver_file, AIL_install_MDI_INI, AIL_install_MDI_driver_file, AIL_install_MDI_driver_image, AIL_open_XMIDI_driver, AIL_set_GTL_filename_prefix, AIL_set_redist_directory
Related Basic Types: HMDIDRIVER, char const *
Related Structures: IO_PARMS