目次 - SDL_mixer 3.0 - MIX_DestroyAudio

MIX_DestroyAudio

指定したオーディオを破棄する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

void MIX_DestroyAudio(MIX_Audio *audio);

引数

MIX_Audio *audiothe audio to destroy.

詳細

MIX_Audioは内部で参照をカウントしており, この関数は参照を解除するだけである. その結果, 参照数が0になったとき, MIX_Audioは解放される. そのため, 破棄しようとしたときまだオーディオがMIX_Trackに割り当てられていても, システムは安全に処理できる. 実際の破棄はそれを使用しているトラックを止めたときに行われる.

しかし, 呼び出し側はこの関数を呼んだ後はオーディオポインタは無効になったとみなすべきである.

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

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

SDL Wikiへのリンク

SDL3_mixer/MIX_DestroyAudio