Miles Sound System SDK 7.2a

AIL_set_sample_address

The function AIL_set_sample_address specifies the starting address and length for a raw data sample.

void AIL_set_sample_address(
  HSAMPLE S,
  void const * start,
  U32 len
);

In Parameters

S: indicates the sample handle whose address and length are to be set.
start: points to the beginning of the desired raw data sample in memory.
len: gives the size of the raw data sample in bytes (not samples).

Discussion

This function must be called after initializing the sample handle with AIL_init_sample, and before starting sample playback with AIL_start_sample.

It is not necessary to call this function if the AIL_set_named_sample_file, AIL_set_sample_file or AIL_set_sample_info function is used to play memory-resident .VOC or .WAV files directly.

None of the digital audio library functions alter or modify application sample data in any way. The same sample data may safely be passed to other drivers (or even used more than once per driver) without being reloaded into memory.

Example files that use this function: SSTEST.C

Group: Digital Audio Services
Related Functions: AIL_init_sample, AIL_sample_buffer_available, AIL_set_named_sample_file, AIL_set_sample_adpcm_block_size, AIL_set_sample_file, AIL_set_sample_info, AIL_set_sample_playback_rate, AIL_start_sample
Related Basic Types: HSAMPLE, U32, void, void const *