# NNS_SndPlayerSetAllocatableChannel

## Syntax

      #include <nnsys/snd.h>

      void NNS_SndPlayerSetAllocatableChannel(
              int playerNo,
              u32 chBitFlag );

## Arguments

`playerNo` | The player number.
`chBitFlag` | This is an allocatable channel bit flag.

## Return Values

None.

## Description

The allocatable channel is configured by sequence that plays back on the designated player. The default is 0, which allows for unlimited allocation.

`chBitFlag` configures the allocatable channel with a bit flag. Shows channel 0, channel 1, channel 2, etc. in order from the lowest bit, and only allows for allocation from channels that have set bits. There are no limitations where the value is 0, and allocation can be performed from all channels.

There are 16 channels. The features of the channels differ depending on the channel number, as indicated below:

Table: Channel Numbers and Functionality

Channel Number | Function
--- | ---
0, 2 | Can playback PCM/ADPCM. Output from these channels can also be used for sound capture input.
1, 3 | Can playback PCM/ADPCM. Because sound capture and the timer are shared, these channels can be used only for sound capture output when sound capture is used.
4 ~ 7 | Can playback PCM/ADPCM. These channels are used preferentially when playing back waveform data on sequence playback.
8 ~ 13 | Can playback PCM/ADPCM and PSG rectangular waveforms.
14, 15 | Can playback PCM/ADPCM and white noise.

### Note

This function is called inside of the `NNS_SndArcPlayerSetup` function. If this function is called again, the set values will be overwritten.

By calling the `NNS_SndPlayerSetTrackAllocatableChannel` for the sequence that was played back, the values that were configured here are overwritten.

## See Also

`NNS_SndArcPlayerSetup`, `NNS_SndPlayerSetTrackAllocatableChannel`

## Revision History

2005/01/05 Initial version.

CONFIDENTIAL