Miles Sound System SDK 7.2a

AIL_install_MDI_driver_image

The function AIL_install_MDI_driver_image Installs and initializes an MSS-compatible .MDI driver file for XMIDI music performance.

HMDIDRIVER AIL_install_MDI_driver_image(
  void const * driver_image,
  U32 size,
  IO_PARMS * const *IO
);

In Parameters

driver_image: points to a memory-resident driver file image.
size: specifies the size of the driver file image in bytes.
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

This is a DOS-only function.

This function is identical to AIL_install_MDI_driver_file, except that the application is responsible for loading the driver file into memory. With AIL_install_MDI_driver_file, the application specifies the driver's DOS filename, and the MSS API loads the driver itself.

As a courtesy to users, and to aid in testing and debugging, please 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.

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

Group: Low-Level DOS Installation Services
Related Functions: AIL_get_IO_environment, AIL_install_DIG_driver_image, AIL_install_MDI_driver_file, AIL_set_GTL_filename_prefix, AIL_set_redist_directory
Related Basic Types: HMDIDRIVER, U32, void const *
Related Structures: IO_PARMS