# NNS_SndHeapLoadState

## 構文

      #include <nnsys/snd.h>

      void NNS_SndHeapLoadState( NNSSndHeapHandle heap, int level );

## 引数

`heap` | サウンドヒープハンドルです。
`level` | 復元する階層レベルです。

## 返り値

なし。

## 説明

サウンドヒープの状態を復元します。

`NNS_SndHeapSaveState`関数で 保存した直後の状態に戻します。 状態を保存してから現在までに確保されたメモリブロックは、全て解放されます。 解放したメモリブロックそれぞれに対して、 `NNS_SndHeapAlloc`関数で設定した コールバック関数が呼びだされます。

階層レベル`level`は、現在の階層レベルの値と同じか、より小さい値を指定します。 0を指定すると、`NNS_SndHeapClear`関数と同じ意味になります。 ヒープは、状態が保存された直後の状態に戻り、現在の階層レベルも指定した値になります。

### 注意

ヒープ中に、 `NNS_SndArcStrmInit`関数または、 `NNS_SndArcStrmSetupPlayer`関数で 確保したストリームバッファが含まれている場合、 この関数中で、ストリームスレッドと同期をとります。

## 参照

NNS_SndHeapSaveState, NNS_SndHeapAlloc, NNS_SndHeapClear, NNS_SndArcStrmInit, NNS_SndArcStrmSetupPlayer

## 履歴

2004/09/02 スレッド同期に関する注意書き追加
2004/06/01 初版