# NNS_SndArcStrmAllocChannel

## 構文

      #include <nnsys/snd.h>

      BOOL NNS_SndArcStrmAllocChannel( int playerNo );

## 引数

`playerNo` | ストリームプレイヤー番号です。値の範囲は、0〜3です。

## 返り値

チャンネルの確保に成功したかどうかを返します。

## 説明

ストリーム再生用のチャンネルを確保します。

確保したチャンネルは、指定したストリームプレイヤーに結びつけられ、 以後そのストリームプレイヤーで再生するストリームは、確保したチャンネルを使用して再生します。

この関数でチャンネルを確保せずに、ストリームを再生した場合は、 `NNS_SndArcStrmStart`関数または、 `NNS_SndArcStrmPrepare`関数内で、 自動的にチャンネルが確保されます。 この関数は、チャンネルを確保するタイミングを制御するために使用します。

確保したチャンネルの解放には、 `NNS_SndArcStrmFreeChannel`関数を呼びだします。

### 注意

再生中のストリームプレイヤーに対して、この関数を呼びだすと、関数は失敗します。

## 参照

NNS_SndArcStrmStart, NNS_SndArcStrmPrepare, NNS_SndArcStrmFreeChannel

## 履歴

2004/11/25 プレイヤーが再生中の時、呼びだした場合の注意書き追加
2004/08/10 初版