Miles Sound System SDK 7.2a

AIL_release_sequence_handle

The function AIL_release_sequence_handle frees a sequence handle for later allocation by AIL_allocate_sequence_handle.

void AIL_release_sequence_handle(
  HSEQUENCE S
);

In Parameters

S: indicates the sequence handle to release.

Discussion

Many applications which follow the guidelines for sequence allocation and playback under AIL_allocate_sequence_handle and AIL_init_sequence will not need to use this function at all. This is because sequence handles, once allocated, may be reused as many times as desired. See the descriptions of the two functions mentioned above for more information.

After a sequence handle is released, no further calls to any sequence-based functions may be executed with the released handle.

MSS version 2's "delayed release" feature is not available in MSS version 3, since sequence handles no longer need to be released and reallocated in order to play new sequences.

Upon termination of the application program, it is not necessary to return allocated sequence handles to the MSS system with AIL_release_sequence_handle calls.

Group: XMIDI Services
Related Functions: AIL_allocate_sequence_handle, AIL_init_sequence, AIL_release_sequence_handle, AIL_stop_sequence
Related Basic Types: HSEQUENCE, void