Miles Sound System SDK 7.2a

AIL_shutdown

The function AIL_shutdown shuts down all active sound drivers, restores normal system timer operation, and disconnects the API timer interrupt handler.

void AIL_shutdown();

Discussion

Like AIL_startup, this function can be called multiple times, but it is the first call that actually shuts down the system. After calling AIL_shutdown once, you must be careful not to call any other MSS functions until you call AIL_startup again.

If you are using the Quick Integration Services, then you should use AIL_quick_shutdown instead of this function.

All application timers are stopped and released by this function, and all drivers are shut down. There is no need to call AIL_release_timer_handle, or AIL_close_digital_driver/AIL_close_XMIDI_driver to shut down any active timers or drivers, if AIL_shutdown is called.

DOS applications which fail to call AIL_shutdown prior to termination may cause abnormal system behavior when starting up subsequent applications. This is because the INT 8 system timer-tick vector is captured by the MSS system when AIL_startup is called. The interrupt vector is not restored to its previous state until AIL_shutdown is called.

Under DOS, Wii, PS2 and MacOS 9, this function must not be invoked from an interrupt-based callback function.

Example files that use this function: All

Group: System Services
Related Functions: AIL_close_XMIDI_driver, AIL_close_digital_driver, AIL_quick_shutdown, AIL_release_timer_handle, AIL_shutdown, AIL_startup, AIL_stop_timer
Related Basic Types: void
Related FAQs: How careful do I have to be when shutting down?, How do I initialize the Miles Sound System for use?