Miles Sound System SDK 7.2a

AIL_register_stream_callback

The function AIL_register_stream_callback arranges for callback service to be provided to an application function immediately upon reaching the end of a stream.

AILSTREAMCB AIL_register_stream_callback(
  HSTREAM stream,
  AILSTREAMCB callback
);

In Parameters

stream: indicates the stream for which end of stream callback service is desired.
callback: should be set to the address of the callback function which is to be invoked just after the last audio data block in a sample is merged into the hardware buffer for playback. A value of NULL cancels end-of-sample callbacks.

Returns

The address of the previously-installed end of stream callback function handler.

Discussion

Most MSS functions can be safely invoked from within callback functions. Exceptions include driver-installation or driver-shutdown functions and any other functions which may perform OS or BIOS calls, such as AIL_open_stream. These exceptions are noted in the descriptions of the functions involved. If in doubt about whether a particular action may safely be performed from within a callback function, contact RAD Game Tools for assistance.

Group: Digital Audio Streaming Services
Related Functions: AILSTREAMCB, AIL_open_stream
Related Basic Types: HSTREAM
Related FAQs: What's the deal with callbacks - are they threads, interrupts, system timers, or what?