# NNS_SndPlayerPause*

## 構文

      #include <nnsys/snd.h>

      void NNS_SndPlayerPause( NNSSndHandle* handle, BOOL flag );
      void NNS_SndPlayerPauseByPlayerNo( int playerNo, BOOL flag );
      void NNS_SndPlayerPauseAll( BOOL flag );

## 引数

`handle` | サウンドハンドルのポインタです。
`playerNo` | プレイヤー番号です。
`flag` | TRUEの時、一時停止し、FALSEの時、再開します。

## 返り値

なし。

## 説明

シーケンスを一時停止または再開します。

`NNS_SndPlayerPause`関数は、サウンドハンドル`handle`に結びつけられたシーケンスの一時停止または再開を行います。サウンドハンドルが無効の場合は、何もしません。

`NNS_SndPlayerPauseByPlayerNo`関数は、プレイヤー番号`playerNo`を指定して、 再生中のシーケンスの一時停止または再開を行います。

`NNS_SndPlayerPauseAll`関数は、全ての再生中のシーケンスの一時停止または再開を行います。

一時停止か再開かは、`flag`で指定します。状態が変わらない場合、例えば、すでに一時停止状態の時に一時停止を行っても、何もしません。

### 注意

シーケンスの一時停止を行うと、そのシーケンスで発音中のチャンネルは強制的に停止させられます（一時停止ではない）。 したがって、シーケンスの一時停止を解除しても、発音中のチャンネルが続きから再生されることはありませんので、 ご注意ください。 （チャンネルの一時停止は、ハードウェアの仕様によりできません。）

## 参照

なし。

## 履歴

2005/09/12 注意書き修正。
2004/08/10 NNS_SndPlayerPauseAll関数の引数が間違っていたのを修正。
2004/06/01 NNS_SndPlayerPauseByNumberをNNS_SndPlayerPauseByPlayerNoに変更。
2004/04/19 NNS_SndPlayerPause, NNS_SndPlayerPauseByNumber, NNS_SndPlayerPauseAll のマニュアルを統合
2004/04/01 初版