# NNS_SndPlayerSetAllocatableChannel

## 構文

      #include <nnsys/snd.h>

      void NNS_SndPlayerSetAllocatableChannel(
              int playerNo,
              u32 chBitFlag );

## 引数

`playerNo` | プレイヤー番号です。
`chBitFlag` | 確保可能なチャンネルのビットフラグです。

## 返り値

なし。

## 説明

指定プレイヤーで再生するシーケンスが、確保できるチャンネルを設定します。 デフォルトは0で、無制限に確保できることを意味します。

`chBitFlag`で、確保できるチャンネルをビットフラグで設定します。 下位ビットから順に、チャンネル0、チャンネル1、チャンネル2、、、を表し、 ビットが立っているチャンネルからのみ確保することができます。 値が0の場合は無制限となり、全てのチャンネルから確保することができます。

なお、チャンネルは16個ありますが、 下記のように、チャンネル番号に応じてチャンネルの機能が異なっています。

表 . チャンネルの番号別機能

チャンネル番号 | 機能
--- | ---
0, 2 | PCM/ADPCMを再生できます。このチャンネルの出力をサウンドキャプチャの入力とすることもできます。
1, 3 | PCM/ADPCMを再生できます。サウンドキャプチャとタイマーを共用しているため、サウンドキャプチャを使うときは、サウンドキャプチャの出力チャンネルとしてしか使えません。
4 〜 7 | PCM/ADPCMを再生できます。シーケンス再生で波形データを再生するときには優先的に使っています。
8 〜 13 | PCM/ADPCMまたは、PSG矩形波を再生できます。
14, 15 | PCM/ADPCMまたは、ホワイトノイズを再生できます。

### 注意

この関数は、`NNS_SndArcPlayerSetup`関数内で、 呼びだされています。再度、この関数を呼びだすと、設定した値が上書きされます。

再生したシーケンスに対して、 `NNS_SndPlayerSetTrackAllocatableChannel`関数を 呼びだすと、ここで設定した値は上書きされます。

## 参照

NNS_SndArcPlayerSetup, NNS_SndPlayerSetTrackAllocatableChannel

## 履歴

2005/01/05 初版