Miles Sound System SDK 7.2a

AIL_background

The function AIL_background allows an application function to determine if it is currently running in "background" mode from an interrupt or thread, or if it is currently running in the "foreground".

S32 AIL_background();

Returns

0 if the application function which called AIL_background is currently running in the foreground. Otherwise, the application function is currently being executed within an MSS timer, XMIDI, or digital sound callback interrupt handler.

Discussion

Application functions which can be executed in both foreground and background contexts may call AIL_background to determine if a certain action is "safe" in the current context.

Most MSS functions can be safely invoked from within timer callback functions. Exceptions include driver-installation or driver-shutdown functions and any other functions which may perform DOS or BIOS calls, such as AIL_init_sequence. These exceptions are noted in the descriptions of the functions involved. If in doubt about whether a particular action may safely be performed from within a callback function, contact RAD Game Tools for assistance.

Group: System Services
Related Functions: AIL_background, AIL_init_sequence
Related Basic Types: S32