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 初版