# NNS_SndArcPlayerSetup

## 構文

      #include <nnsys/snd.h>

      BOOL NNS_SndArcPlayerSetup( NNSSndHeapHandle heap );

## 引数

`heap` | サウンドヒープハンドルです。

## 返り値

セットアップに成功したかどうかを返します。

## 説明

サウンドアーカイブで定義されているプレイヤー設定に基づいて、プレイヤーをセットアップします。 不要ならこの関数を呼ばずに初期設定をそのまま使うこともできますし、この関数を呼んだ後に設定を変更することもできます。

あらかじめ、 `NNS_SndArcInit`関数または、 `NNS_SndArcInitOnMemory`関数で サウンドアーカイブが初期化されている必要があります。

`heap`で指定したサウンドヒープから、プレイヤーヒープを作成するためのメモリが確保されます。 プレイヤーヒープを作成しない場合は、NULLを入れます。 指定したヒープから十分なメモリが確保できない場合、関数は失敗します。

関数内部では、サウンドアーカイブに格納されているプレイヤー情報に従い、 `NNS_SndPlayerSetPlayableSeqCount`関数及び、 `NNS_SndPlayerSetAllocatableChannel`関数及び、 `NNS_SndPlayerCreateHeap`関数を呼びだしています。

## 参照

NNS_SndArcInit, NNS_SndArcInitOnMemory, NNS_SndPlayerSetPlayableSeqCount, NNS_SndPlayerSetAllocatableChannel, NNS_SndPlayerCreateHeap

## 履歴

2005/01/05 NNS_SndPlayerSetAllocatableChannel呼び出し追加
2004/06/01 初版