Miles Sound System SDK 7.2a

AIL_quick_load_named_mem

The function AIL_quick_load_named_mem loads a sound file that is already loaded into memory, with a filename hint, returning a handle that can be used with the other quick API functions.

HAUDIO AIL_quick_load_named_mem(
  void const * mem,
  char const * filename,
  U32 size
);

In Parameters

mem: specifies the address of a loaded .WAV, .MP3, .OGG, .VOC, .MID or .XMI file.
filename: specifies the filename of the data loaded at mem - this is used to load memory buffers of suond data that we can't positively identify without a filename hint (like voice chat buffers).
size: specifies the length of the data in bytes.

Returns

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

Discussion

This function can read Microsoft .WAV files, XMA- or IMA ADPCM-compressed .WAV files, MPEG Layer-3 files, Ogg Vorbis files, Voxware Voice chat compressed files, Creative Labs .VOC files, normal MIDI files, or XMIDI files.

You must call AIL_quick_unload on all handles returned by this function. The memory image provided to this function must not be freed until AIL_quick_unload has been called.

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

Example files that use this function: MilesPly.C

Group: Quick Integration Services
Related Functions: AIL_quick_copy, AIL_quick_load, AIL_quick_load_and_play, AIL_quick_unload
Related Basic Types: HAUDIO, U32, char const *, void const *