ReleaseScoreNote

Releases a MIDI note, uses voice allocation.

Synopsis

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

Description

This function releases a note for the score context and uses dynamic voice allocation to do so. It is equivalent to a MIDI NoteOff 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 release velocity value of the note (0..127).

Return Value

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

Caveats

At present, release velocity is ignored.

Implementation

Library call implemented in music.lib V20.

Associated Files

score.h, music.lib

See Also

FreeChannelInstruments(), NoteOnIns(), NoteOffIns(), StartScoreNote(), StopScoreNote()