# NNS_SndPlayerSetInitialVolume

## 構文

      #include <nnsys/snd.h>

      void NNS_SndPlayerSetInitialVolume(
              NNSSndHandle* handle,
              int volume );

## 引数

`handle` | サウンドハンドルのポインタです。
`volume` | 初期ボリュームの値です。値の範囲は、0〜127です。

## 返り値

なし。

## 説明

シーケンスの初期ボリューム値を設定します。

サウンドハンドル`handle`に結びつけられたシーケンスの初期ボリューム値を設定します。 サウンドハンドルが無効の場合は、何もしません。

ボリューム`volume`のデフォルト値は、最大の127です。 この値の影響は、シーケンス全体にかかります。

### 注意

この関数は、`NNS_SndArcPlayerStartSeq*`関数と `NNS_SndArcPlayerStartSeqArc*`関数内で 呼びだされています。 再度、この関数を呼びだすと、設定した値が上書きされます。上書きしたくない場合は、 `NNS_SndPlayerSetVolume`関数などを使ってください。

## 参照

NNS_SndArcPlayerStartSeq*, NNS_SndArcPlayerStartSeqArc*, NNS_SndPlayerSetVolume

## 履歴

2004/06/01 初版