Miles Sound System SDK 7.2a

AIL_true_sequence_channel

The function AIL_true_sequence_channel returns the physical MIDI channel number which receives MIDI and XMIDI messages transmitted on a logical channel sequence_channel by a given sequence S.

S32 AIL_true_sequence_channel(
  HSEQUENCE S,
  S32 seq_channel
);

In Parameters

S: specifies the sequence for which a true (physical) channel number is to be returned.
seq_channel: specifies the remapped sequence channel for which a true (physical) channel number is to be returned.

Returns

The physical channel to which seq_channel is mapped in the specified sequence.

Discussion

As with all XMIDI functions which require an explicit channel parameter, MIDI channel numbers are passed to and from the MSS API in 1-based format (1-16), rather than the 0-based format (0-15) used when composing MIDI Status byte values.

This function allows the application to obtain the actual MIDI channel number to which a locked sequence channel (typically a MIDI channel from 11-16) has been mapped, either through a call to AIL_map_sequence_channel or by execution of an XMIDI Channel Lock (110) controller event. The application may use the returned MIDI channel number to send MIDI Channel Voice messages to the sequence's physical, or true, channel via the AIL_send_channel_voice_message function.

Group: XMIDI Services
Related Functions: AIL_map_sequence_channel, AIL_send_channel_voice_message
Related Basic Types: HSEQUENCE, S32