Miles Sound System SDK 7.2a

AIL_channel_notes

The function AIL_channel_notes returns the number of notes currently turned "on" in a given MIDI channel.

S32 AIL_channel_notes(
  HSEQUENCE S,
  S32 channel
);

In Parameters

S: indicates the sequence for which a channel-based note count is to be determined.
channel: indicates the channel number in which the number of "on" notes is to be determined.

Returns

The number of notes currently playing in the specified channel.

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 is intended for use in special-purpose applications (such as editors and test programs) where an indication of channel note activity is useful. Most applications will not need to call AIL_channel_notes.

Group: XMIDI Services
Related Functions: AIL_channel_notes, AIL_controller_value
Related Basic Types: HSEQUENCE, S32