SetVoiceNote
Syntax
int SetVoiceNote(nVoice,nValue,nLength,nCdots)
This function queues a note that has the qualities given by the nValue, nLength, and nCdots parameters in the voice queue specified by the nVoice parameter. An error occurs if there is insufficient room in the queue. The function always leaves space in the queue for a single sync mark.
| Parameter |
Type/Description |
|
| nVoice |
int Specifies the voice queue to receive the note. If nVoice is out of range, the SetVoiceNote function is ignored. |
|
| nValue |
int Specifies 1 of 84 possible notes (seven octaves). If nValue is zero, a rest is assumed. |
|
| nLength |
int Specifies the reciprocal of the duration of the note. For example, 1 specifies a whole note, 2 a half note, 4 a quarter note, and so on. |
|
| nCdots |
int Specifies the duration of the note in dots. The duration is equal to nLength ´ (nCdots ´ 3/2). |
|
Return Value
The return value specifies the result of the function. It is zero if the function is successful. If an error occurs, the return value is one of the following values:
| S_SERDCC |
Invalid dot count |
|
| S_SERDLN |
Invalid note length |
|
| S_SERDNT |
Invalid note |
|
| S_SERQFUL |
Queue full |
|