Sint64 MIX_TrackFramesToMS(MIX_Track *track, Sint64 frames);
| MIX_Track * | track | 調査するトラック |
| Sint64 | frames | ミリ秒に変換するトラック固有のサンプルフレーム数 |
この関数はトラックの現在の入力の形式に基づいて時間を求める. 入力が変わると形式が変わる場合があり, さらに入力がストリームの途中で形式を変える場合もある(例えば, 2つのMP3を結合したファイルをデコードする場合).
サンプルフレーム数はミリ秒よりも高精度のため, やむを得ずこの関数は最も近いミリ秒に切り捨てて近似する.
様々な理由のエラー(MIX_Init()が呼ばれていない, トラックがNULLなど)の場合, この関数は-1を戻す.
トラックに入力がない場合, -1を戻す.
framesが0未満のとき, -1を戻す.
この関数はどのスレッドからも安全に呼べる.