目次 - SDL_mixer 3.0 - MIX_PauseTag

MIX_PauseTag

特定のタグの全てのトラックを一時停止する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

bool MIX_PauseTag(MIX_Mixer *mixer, const char *tag);

引数

MIX_Mixer *mixerトラックを一時停止するミキサー
const char *tagトラックの検索で使用するタグ

戻り値

(bool) 成功のとき真, エラーのとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

トラックの一時停止は「停止中」とはみなされないため, 一時停止してもMIX_TrackStoppedCallbackは呼ばれないが, デフォルトでは一時停止が解除されるまではオーディオが生成されたり, 処理が進むことはない.

この関数は指定したミキサーの特定のタグの再生中のトラックを一時停止状態にする. 再生は後で再開できる.

指定したタグと一致するが再生中でないトラックは無視される.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_LoadAudio