# NNS_SndHeapSaveState

## 構文

      #include <nnsys/snd.h>

      int NNS_SndHeapSaveState( NNSSndHeapHandle heap );

## 引数

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

## 返り値

状態保存後の階層レベルを返します。状態の保存に失敗すると、-1を返します。

## 説明

サウンドヒープの状態を保存します。

ヒープ作成直後の階層レベルは0で、この関数を呼ぶ毎に、階層レベルが１つ増えます。 `NNS_SndHeapLoadState`関数を呼びだすことで、 指定した階層レベルの保存直後の状態に復元させることができます。

状態の保存には、ヒープを少し消費します。ヒープの空き容量が少ない場合は、関数に失敗します。

## 参照

NNS_SndHeapLoadState

## 履歴

2004/06/01 初版