#include <nnsys/snd.h>void NNS_SndPlayerSetTrackAllocatableChannel( NNSSndHandle* handle, u16 trackBitMask, u32 chBitFlag );
handle |
The sound handle pointer. |
trackBitMask |
This is the track bit mask. |
chBitFlag |
This is an allocatable channel bit flag. |
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. If the value is 0, none of the channels can be allocated.
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. |
Calling this function will overwrite the value configured with the NNS_SndPlayerSetAllocatableChannel function.
NNS_SndPlayerSetAllocatableChannel
11/07/2005 Corrected the explanation of the channel bit flag when the value is 0
01/05/2005 Initial version
CONFIDENTIAL