目次 - SDL_mixer 3.0 - MIX_PauseTrack

MIX_PauseTrack

再生中の全てのトラックを一時停止する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

bool MIX_PauseTrack(MIX_Track *track);

引数

MIX_Track *track一時停止を解除するトラック

戻り値

(bool) トラックの一時停止が解除されたとき真, エラーのとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

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

どのような状態(再生中, 既に一時停止している, 停止中)でも一時停止を解除させようとしてもよい. トラックが現在一時停止中でなければ, 何も起こらず真を戻す. 偽を戻すのはエラー(MIX_Init()が呼ばれていない, トラックがNULLなど)の場合のみである.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_LoadAudio