# SND_SetPlayerChannelPriority

## Syntax

      #include <nitro/snd.h>

      void SND_SetPlayerChannelPriority( int playerNo, int prio );

## Arguments

`playerNo` | The player number. Takes a value between 0 and 15.
`prio` | The sound priority. Takes a value between 0 and 127. Larger values have higher priority.

## Return Values

None.

## Description

Changes the sound priority in the sequence being played by the Player specified by `playerNo`.

The sound priority `prio` default value is 64. In actual practice, this is added to the priority values set in the sequence data for each track to get the ultimate priority value.

### Note

This function is an ARM7 reserved function. After this function is called, its processing will occur only after the command is issued with the `SND_FlushCommand` function.

If program execution must be synchronized with process completion, first use the `SND_GetCurrentCommandTag` function to obtain the command tag immediately after calling this function. Then, after the command is issued, use the command tag and call either the `SND_IsFinishedCommandTag` or `SND_WaitForCommandProc` function to confirm that processing has finished or to wait for it to complete.

## See Also

`SND_FlushCommand, SND_GetCurrentCommandTag, SND_IsFinishedCommandTag, SND_WaitForCommandProc`

## Revision History

2005/02/17 Added a note about ARM7 command processing.
2004/07/20 Initial version.

CONFIDENTIAL