Miles Sound System SDK 7.2a

AIL_get_IO_environment

The function AIL_get_IO_environment searches for and evaluates a DOS environment variable which contains I/O configuration data for a particular MSS driver.

IO_PARMS * AIL_get_IO_environment(
  AIL_DRIVER * drvr
);

In Parameters

drvr: points to an AIL_DRIVER driver descriptor structure. 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. To obtain a pointer to an AIL_DRIVER structure for a variable x of type HDIGDRIVER or HMDIDRIVER, use an expression of the form x->drvr.

Returns

A pointer to a static structure of type IO_PARMS, which contains information about a driver's I/O port configuration.

Discussion

This is a DOS-only function.

This function is called internally by the higher-level AIL_install_DIG_driver_file/AIL_install_MDI_driver_file and AIL_install_DIG_driver_image/AIL_install_MDI_driver_image functions, as part of the auto-detection process which these functions will perform if a valid IO_PARMS structure is not passed to them explicitly. Most applications, with the possible exception of installation programs, will not need to use this function. Installation programs may, if desired, call AIL_get_IO_environment to obtain the "default" values to be used in prompting the end-user for I/O information prior to accessing any hardware ports. Most Sound Blaster-equipped systems contain a BLASTER environment variable, for instance, which contains all information necessary to communicate with the card.

Under DOS, 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_file, AIL_install_DIG_driver_image, AIL_install_MDI_driver_file, AIL_install_MDI_driver_image, AIL_read_INI
Related Basic Types: AIL_DRIVER
Related Structures: IO_PARMS