目次 - SDL_mixer - API(機能別) - チャネル - Mix_HaltChannel

Mix_HaltChannel

指定のチャネルを停止する

構文

int Mix_HaltChannel(int channel)

引数

channel停止するチャネル. -1のとき全チャネル

戻り値

成功のとき0, エラーのとき-1を戻す.

詳細

この関数は新しいチャンクの再生が開始されるまで指定のチャネルでの再生を停止する.

チャネルに-1を指定すると, 現在再生中の音楽を除き全てのチャネルが停止する.

停止したチャネルに設定されたエフェクトは解除され, Mix_ChannelFinished()で設定されたコールバックがこの関数から戻る前に呼ばれる.

チャネルにMAX_CHANNEL_POSTを指定してはならない.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_HaltChannel