Miles Sound System SDK 7.2a

AIL_quick_load

The function AIL_quick_load loads a sound file, returning a handle that can be used with the other quick API functions.

HAUDIO AIL_quick_load(
  char const * filename
);

In Parameters

filename: specifies the name of a .WAV, .MP3, .OGG, .VOC or .XMI file.

Returns

A new audio handle if the function was successful, NULL otherwise.

Discussion

This function can load Microsoft .WAV files (uncompressed, XMA, or IMA ADPCM compressed), MPEG Layer-3 files, Ogg Vorbis files, Creative Labs .VOC files, or XMIDI files.

You must call AIL_quick_unload on all handles returned by this function.

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

Example files that use this function: Quick.C, Play.C

Group: Quick Integration Services
Related Functions: AIL_quick_copy, AIL_quick_fss_load, AIL_quick_fss_load_and_play, AIL_quick_load_and_play, AIL_quick_load_mem, AIL_quick_load_named_mem, AIL_quick_unload
Related Basic Types: HAUDIO, char const *
Related FAQs: How do I play a digital sound?