AXSetVoicePriority

Syntax

#include <revolution/ax.h>

#define AX_PRIORITY_NODROP  31
#define AX_PRIORITY_LOWEST  1

void AXSetVoicePriority(AXVPB *pvpb, u32 priority);

Arguments

pvpb Pointer to the voice.
priority New priority for the voice. Set from 1 (minimum) - 31 (maximum). 31 is the highest priority. AX_PRIORITY_NODROP is defined as 31. AX_PRIORITY_LOWEST is defined as 1. Priority 0 means that the voice is empty.

Return Values

None.

Description

The AXSetVoicePriority function changes the priority for the specified voice. As an example, consider a synthesizer application that acquires a voice to produce a note in a score. Once the keyoff event is encountered, the voice enters the release phase and the priority of the voice may then be lowered to facilitate voice reacquisition.

See Also

AXAcquireVoice

Revision History

2006/03/01 Initial version.

CONFIDENTIAL