# NoteOnIns

Turns on a note for an instrument.

### Synopsis

`Err NoteOnIns( Item Instrument, int32 Note, int32 Velocity )`

### Description

This function turns on a note for an instrument and specifies the pitch and velocity for the instrument to play the note. The function does not use voice allocation for the note. It's called by `StartScoreNote()` after `StartScoreNote()` has worked out voice allocation.

### Arguments

Instrument
  The item number of the instrument.

Note
  The MIDI pitch value of the note.

Velocity
  The MIDI attack velocity value of the note. 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

``NoteOffIns`(), ReleaseScoreNote(), StartScoreNote()`