#include <n_libaudio.h>
s32   n_alSynAllocVoice(N_ALVoice *voice, ALVoiceConfig *vc);

Arguments

• voice is the pointer to a virtual voice to be initialized and allocated a physical voice
• vc is the pointer to a voice configuration structure

Explanation
This function is available in the n_audio library. It allocates the synthesizer voice. Specifically, it initializes the virtual voice using the arguments specified in the voice configuration structure, and it allocates a physical voice to the initialized virtual voice. If there are no physical voices available, it tries to steal a physical voice from another virtual voice. To do this, it searches the list of voices and steals the physical voice with the lowest priority voice that is equal to or lower than the priority specified in the configuration structure. If no physical voice is found with an equal or lower priority or if an error occurs, it returns 0 to indicate failure. If a physical voice is allocated and no errors occur, it returns 1 to indicate success. Note that voice stealing occurs only when there are more virtual voices than physical voices.

The arguments in the ALVoiceConfig structure are as follows:

• priority is the voice's playback priority.
• fxBus is the auxiliary effect bus to which the voice is assigned. Currently there is only one auxiliary bus.
• unityPitch is a flag that when set specifies that this voice is to be played at a pitch of 1.0.

Nintendo® Confidential Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility. Copyright © 1998 Nintendo of America Inc. All rights reserved Nintendo and N64 are registered trademarks of Nintendo Last Updated April, 1999