int MIX_GetTrackLoops(MIX_Track *track);
| MIX_Track * | track | 問い合わせるトラック |
この戻り値は残されたループの回数である. トラックの終了後にあと1回再生がある場合, この関数は1を戻す. ループするトラックだが, 最後のループの場合(これが完了したとき停止する), この関数は0を戻す.
トラックが無限にループする場合, -1を戻す. この値はエラーではない.
停止したトラック(再生中でなく, 一時停止中でない)は0回のループが残っているとみなされる.
様々な理由のエラー(MIX_Init()が呼ばれていない, トラックがNULLなど)の場合, この関数は0を戻すが, エラーとループのないトラックを判別する手段はない.
この関数はどのスレッドからも安全に呼べる.