Miles Sound System SDK 7.2a

AIL_quick_load_and_play

The function AIL_quick_load_and_play loads a sound file into a handle and begins playing it immediately.

HAUDIO AIL_quick_load_and_play(
  char const * filename,
  U32 loop_count,
  S32 wait_request
);

In Parameters

filename: specifies the name of a .WAV, .VOC, .MP3, .OGG, or .XMI file.
loop_count: specifies the number of times to loop the audio handle (use 0 to loop forever).
wait_request: specifies whether the function should wait until the playback is complete before returning.

Returns

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

Discussion

This function can load uncompressed Microsoft .WAV files, IMA ADPCM compressed .WAV files, Creative Labs .VOC files, Ogg Vorbis files, MPEG Layer 3 files, or XMIDI files. This function will begin playback immediately (unlike AIL_quick_load ).

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.

Group: Quick Integration Services
Related Functions: AIL_quick_copy, AIL_quick_fss_load, AIL_quick_load, AIL_quick_load_mem, AIL_quick_load_named_mem, AIL_quick_play, AIL_quick_unload
Related Basic Types: HAUDIO, S32, U32, char const *