Miles Sound System SDK 7.2a

AIL_set_sample_buffer_count

The function AIL_set_sample_buffer_count sets the number of low-level streaming buffers available for use with a given sample handle.

S32 AIL_set_sample_buffer_count(
  HSAMPLE S,
  S32 n_buffers
);

In Parameters

S: indicates the sample for which the specified number of low-level streaming buffers are to be allocated.
n_buffers: indicates the number of desired low-level streaming buffers.

Returns

Nonzero if the allocation succeeded; 0 if the allocation failed.

Discussion

All HSAMPLEs have at least 2 low-level streaming buffer pointers by default. Additional streaming buffer pointers may be allocated with this function. (Note that these are only internal descriptors, not the buffers themselves. The actual data buffers used for low-level streaming are owned by the application.

Most applications should use high-level (HSTREAM) functions instead of low-level streaming.

Group: Digital Audio Services
Related Functions: AIL_load_sample_buffer, AIL_minimum_sample_buffer_size, AIL_sample_buffer_available, AIL_sample_buffer_count
Related Basic Types: HSAMPLE, HSTREAM, S32