void MIX_UntagTrack(MIX_Track *track, const char *tag);
| MIX_Track * | track | タグを取り除くトラック |
| const char * | tag | 取り除くタグ |
タグにはUTF-8でコード化したあらゆる有効なC文字列を設定できる. これは様々な目的でトラックをグループ化する場合に有用である. 例えばゲーム中で使用する全てのトラックに"game"をマークすると, ユーザが設定メニューを開いたとき, アプリケーションは即座にゲームプレーに関係する全てのトラックを一時停止させるがBGMと効果音は継続するようなことができる.
トラックに関連付けられていないタグを取り除こうとしても問題ない. この関数はエラーを報告しないが, 単に何も起こらない.
タグとしてNULLを指定すると, 全てのタグが取り除かれる.
この関数はどのスレッドからも安全に呼べる.