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).

The priority affects the behavior when getting voices and when controlling the DSP processing load. See the description of the nn::snd::CTR::AllocVoice function.

Among voices that are set to the same level of priority, the voice that was set last takes the highest priority. Because the nn::snd::CTR::AllocVoice function sets the level of priority internally, that function is also included in the above description.

The Voice specified as VOICE_PRIORITY_NODROP in the nn::snd::CTR::AllocVoice function cannot have its priority changed in this function. In addition, a Voice with a normal priority (a priority below VOICE_PRIORITY_NODROP) cannot have its priority changed to VOICE_PRIORITY_NODROP.

2011/05/26

Added mention of the ordering of voices set to the same priority level.

2010/10/21

Added restrictions specific to priority and revised operations that can affect priority.

2010/01/29

Initial version.