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 初版