Miles Sound System SDK 7.2a

AIL_install_driver

The function AIL_install_driver registers an MSS-compatible driver of any supported type with the MSS API, returning an AIL_DRIVER descriptor.

AIL_DRIVER * AIL_install_driver(
  U8 const * driver_image,
  U32 n_bytes
);

In Parameters

driver_image: points to a memory-resident image of the driver to be installed.
n_bytes: is the size of the driver image in bytes.

Returns

A pointer to a dynamically allocated structure of type AIL_DRIVER driver. AIL_DRIVER may be thought of as the "base class" from which high-level MSS driver types such as DIG_DRIVER and MDI_DRIVER are derived, or NULL if any errors occur. For example, a pointer to an AIL_DRIVER structure for a variable x of type HDIGDRIVER or HMDIDRIVER may be obtained by using an expression of the form x->drvr.

Discussion

This is a DOS-only function.

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

Group: Low-Level DOS Installation Services
Related Functions: AIL_uninstall_driver
Related Basic Types: AIL_DRIVER, U32, U8