Miles Sound System SDK 7.2a

AIL_startup

The function AIL_startup initializes the Miles Sound System and prepares for the installation and use of sound drivers.

S32 AIL_startup();

Returns

Non-zero if the library was initialized by the current call to AIL_startup, or zero if the library was initialized by an earlier call to AIL_startup.

Discussion

This function must be called before any other API functions except AIL_set_redist_directory and Register_RIB are used. You can call this function multiple times, but the system will only be initialized the first time.

On Win32, Win64, MacOS and Linux, you must call AIL_set_redist_directory to set your application's Miles directory before calling this function. On all platforms except those that support x86 (Win32) DLLs, you should call Register_RIB to load any static filters or decompressors that your application needs before calling AIL_startup.

You can also call AIL_quick_startup and AIL_quick_shutdown to initialize and shut down the Miles system. However, note that you must call AIL_shutdown to shut down the library if it was originally initialized by AIL_startup.

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: Digital Filter Services, System Services
Related Sections: Miles DTS Provider for the Sony PS2
Related Functions: AIL_last_error, AIL_mem_use_free, AIL_mem_use_malloc, AIL_quick_shutdown, AIL_quick_startup, AIL_register_trace_callback, AIL_set_named_sample_file, AIL_set_redist_directory, AIL_set_timer_divisor, AIL_set_timer_frequency, AIL_set_timer_period, AIL_shutdown, AIL_startup, Register_RIB
Related Basic Types: MILES_PREFERENCES, S32
Related FAQs: How do I initialize the Miles Sound System for use?, How do I use a Unicode path on Windows?, I'm setting a preference and it isn't having any effect - what's going on?