StartScoreNote

Starts a MIDI note, uses voice allocation.

Synopsis

Err StartScoreNote( ScoreContext *scon, int32 Channel,int32 Note, int32 Velocity )

Description

This function turns on a note for the score context and uses dynamic voice allocation to do so. It is equivalent to a MIDI Note On message.

Arguments

scon
A pointer to a ScoreContext data structure controlling playback.
Channel
The number of the MIDI channel in which to play the note.
Note
The MIDI pitch value of the note (0..127).
Velocity
The MIDI attack velocity value of the note (0..127). If attack velocity is 0, the specified note is released (identical behavior to the MIDI Note On event).

Return Value

This function returns a non-negative value if successful or an error code (a negative value) if an error occurs.

Implementation

Library call implemented in music.lib V20.

Associated Files

score.h, music.lib

See Also

FreeChannelInstruments(), NoteOnIns(), NoteOffIns(), ReleaseScoreNote(),StopScoreNote()