Miles Sound System SDK 7.2a

AIL_read_INI

The function AIL_read_INI reads a standard MSS MDI.INI or DIG.INI file, parses it, and stores its contents in an application-specified AIL_INI structure.

S32 AIL_read_INI(
  AIL_INI *INI,
  char const * filename
);

In Parameters

filename: specifies the filename of the .INI file to read. The SETSOUND driver configuration program creates .INI files with the standard names DIG.INI and MDI.INI.

Out Parameters

INI: points to an instance of a structure of type AIL_INI, which will be filled with the parsed contents of the MDI.INI or DIG.INI file.

Returns

0 if the .INI file was not present or could not be parsed; otherwise 1.

Discussion

This is a DOS-only function.

This function is used internally by the AIL_install_DIG_INI and AIL_install_MDI_INI functions to parse the driver configuration files written by the SETSOUND driver configuration utility. Most applications can use these two functions to install the selected drivers automatically, rather than calling AIL_read_INI directly.

An example of a valid .INI file, as written by the SETSOUND utility, follows:


;
;RAD Game Tools: Miles Sound System V6.0a of 11-Nov-99
;
DEVICE Creative Labs Sound Blaster(TM) or 100% compatible
DRIVER SBLASTER.DIG
IO_ADDR 220h
IRQ 5
DMA_8_BIT 1
DMA_16_BIT -1

Group: Low-Level DOS Installation Services
Related Sections: SETSOUND - MSS Sound Configuration Utility
Related Functions: AIL_get_IO_environment, AIL_install_DIG_INI, AIL_install_MDI_INI, AIL_read_INI
Related Basic Types: S32, char const *
Related Structures: AIL_INI