Miles Sound System SDK 7.2a

AIL_quick_copy

The function AIL_quick_copy copies an audio handle from an already-loaded audio handle.

HAUDIO AIL_quick_copy(
  HAUDIO audio
);

In Parameters

audio: is the handle you which to duplicate.

Returns

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

Discussion

This function lets you play a single audio file more than once. Note that only the header is actually copied - the digital sound or MIDI data is only loaded once.

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

The memory containing the digital sound or MIDI data won't be freed until the original audio handle and all copied handles have been unloaded.

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_fss_load, AIL_quick_fss_load_and_play, AIL_quick_load, AIL_quick_load_and_play, AIL_quick_load_mem, AIL_quick_load_named_mem, AIL_quick_unload
Related Basic Types: HAUDIO