Miles Sound System SDK 7.2a

AIL_register_sequence_callback

The function AIL_register_sequence_callback registers an application function to be called immediately upon completion of playback of an XMIDI sequence.

AILSEQUENCECB AIL_register_sequence_callback(
  HSEQUENCE S,
  AILSEQUENCECB callback
);

In Parameters

S: indicates the sequence with which the end-of-sequence callback function handler is to be associated.
callback: should be set to the address of an application function prototyped as an AILSEQUENCECB callback.

Returns

The address of the previously-installed end-of-sequence function handler.

Discussion

The end-of-sequence function handler will be called after the expiration of all loop iterations executed in accordance with the AIL_set_sequence_loop_count function.

If desired, the sequence may be restarted by calling AIL_start_sequence from within an end-of-sequence callback function handler.

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 DOS or BIOS calls, such as AIL_init_sequence. 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: XMIDI Services
Related Functions: AILSEQUENCECB, AIL_init_sequence, AIL_register_beat_callback, AIL_register_event_callback, AIL_register_prefix_callback, AIL_register_timbre_callback, AIL_register_trigger_callback, AIL_set_sequence_loop_count, AIL_start_sequence
Related Basic Types: HSEQUENCE
Related FAQs: What's the deal with callbacks - are they threads, interrupts, system timers, or what?