目次 - SDL_mixer 3.0 - MIX_DestroyTrack

MIX_DestroyTrack

指定したトラックを破棄する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

void MIX_DestroyTrack(MIX_Track *track);

引数

MIX_Mixer *mixer破棄するトラック

詳細

トラックが再生中の場合, フェードアウトなしで即座に停止する. MIX_SetTrackStoppedCallback()で設定したコールバックは呼ばれない.

ミキサーが別のスレッドでミックスしていた場合, 完了までブロックされる. トラックをミキサースレッド自身(コールバック中)で破棄しようとすると, ミキサースレッドの反復処理で使用されなくなると即座に破棄される. この場合, トラックを破棄した後でさらに変更を行うことは未定義の動作とみなされる.

NULLのMIX_Trackを破棄しようとした場合, 安全になにもしない.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

SDL Wikiへのリンク

SDL3_mixer/MIX_DestroyTrack