nn::snd::CTR::Voice::SetPriority Member Function

void SetPriority(
     s32 priority
);

	Name	Description
in	priority	Priority

None.

Sets the priority of a voice.

The priority takes a value between 0 (the lowest) and VOICE_PRIORITY_NODROP (the highest). Processing runs in LIFO (last in, first out) order.

Priority affects the following operations.

Play

At each sound frame, the processor load is calculated for voices that have received playback instructions and the playback state is adjusted. Low-priority voices may not be played back when there are many voices to play. In this case, behavior depends upon the priority that is set. Normal priority: The voice is stopped and the callback function set by AllocVoice is invoked. VOICE_PRIORITY_NODROP: The voice transitions to the stopped state. Playback resumes immediately when it becomes possible.

Getting a voice

See the description of nn::snd::AllocVoice.

2010/01/29

Initial version.