Miles Sound System SDK 7.2a

AIL_resume_sequence

The function AIL_resume_sequence resumes playback of a sequence which was previously stopped.

void AIL_resume_sequence(
  HSEQUENCE S
);

In Parameters

S: indicates the sequence to resume playing.

Discussion

AIL_resume_sequence is usable only after sequence playback has been stopped with a call to AIL_stop_sequence. It has no effect on sequences whose status is not SEQ_STOPPED.

When AIL_resume_sequence is called, all MIDI and XMIDI controller values, Program Change values, and Pitch Bender values for all of the sequence's channels are restored to their values at the time AIL_stop_sequence was called. Formerly-locked channels (if any) are re-locked, and playback continues exactly as if the sequence had never been interrupted even if other sequences were played on the same MIDI channels while the original sequence was stopped.

Since all notes in a sequence are turned off when the sequence is stopped, the same notes may appear to be "missing" immediately after the track is restarted. This condition is unavoidable due to the nature of MIDI synthesizers, but will remedy itself quickly as the sequence progresses past the point of interruption.

Group: XMIDI Services
Related Functions: AIL_end_sequence, AIL_resume_sequence, AIL_sequence_status, AIL_set_sequence_tempo, AIL_set_sequence_volume, AIL_start_sequence, AIL_stop_sequence
Related Basic Types: HSEQUENCE, MILES_SEQUENCE_STATUS, void
Related FAQs: How do I start an audio file somewhere in the middle?