bool MIX_SetTrackLoops(MIX_Track *track, int num_loops);
| MIX_Track * | track | 設定するトラック |
| int | num_loops | 新しいループ回数. 0のときループしない. -1のとき無限にループする |
この関数は以前に設定された残りループ回数を上書きする.
この値が1の場合, 1回先頭にループする.
0は全くループしない.
-1は無限にループする.
入力はシーク不能でnum_loopsが0でない場合, この関数は成功を戻すが, トラックはループすべき箇所で停止する.
ループ回数を新しく設定すると, トラックが既にループした場合でも以前の状態が上書きされる.
この関数は停止中のトラックには影響せず, 停止中のトラックが開始すると, この値を新しいループ回数が上書きする. 停止したトラックのループ回数はMIX_PROP_PLAY_LOOPS_NUMBERで設定できる. この関数は再生の途中でループ回数を変更することを意図している.
この関数はどのスレッドからも安全に呼べる.