# NNS_SndPlayerSetTrackAllocatableChannel

## C Specification

      #include <nnsys/snd.h>

      void NNS_SndPlayerSetTrackAllocatableChannel(
      NNSSndHandle*   handle,
      u16 trackBitMask,
      u32 chBitFlag );

## Arguments

`handle` | The sound handle pointer.
`trackBitMask` | This is the track bit mask.
`chBitFlag` | This is an allocatable channel bit flag.

## Return Values

None.

## Description

Updates the allocatable channels of the sequence track.

The track volume of the sequence bound to the Sound Handle is changed. This function does not perform any action if the stream handle is invalid.

`trackBitMask` specifies the track to be set. Shows track 0, track 1, track 2, etc. in order from the lowest bit, and changes the allocatable channel for all tracks with active bits. For example, if you want to change the allocatable channels for track 2 and track 5, designated (1<<2)|(1<<5), or 0x0024.

`chBitFlag` configures the allocatable channel with a bit flag. Shows channel 0, channel 1, channel 2 in order from the lowest bit, and only allows for allocation from channels that have active 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: Use of each channel and its 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

Calling this function will overwrite the value configured with the `NNS_SndPlayerSetAllocatableChannel` function.

## See Also

NNS_SndPlayerSetAllocatableChannel

## Revision History

01/05/2005 Initial version.