Miles Sound System SDK 7.2a

AIL_quick_fss_load_and_play

The function AIL_quick_fss_load_and_play loads a Mac file spec sound into a handle and begins playing it immediately.

HAUDIO AIL_quick_fss_load_and_play(
  FSSpec const * file_spec,
  U32 loop_count,
  S32 wait_request
);

In Parameters

file_spec: specifies the a Mac FSSpec structure 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 is only used on the Mac with the Classic or Carbon CFM libraries - the Mach-O version of Miles just uses normal Unix style slash separated string filenames.

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_fss_load ).

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

This function must not be invoked from an interrupt-based callback function.

Group: Quick Integration Services
Related Sections: Filenames on MacOS
Related Functions: AIL_quick_copy, AIL_quick_fss_load, AIL_quick_load, AIL_quick_load_mem, AIL_quick_play, AIL_quick_unload
Related Basic Types: FSSpec, HAUDIO, S32, U32