ov_time_seek_page

declared in "vorbis/vorbisfile.h"; 　"vorbis/vorbisfile.h"で定義されている

For seekable streams, this seeks to closest full page preceding the given time. This function is faster than ov_time_seek because it doesn't seek through the last few samples to reach an exact time, but it is also less accurate. This should be used when speed is important.
移動可能なストリームで、指定した時間に先行する最も近い完全なページに移動する。 この関数は ov_time_seek に比べて高速である。なぜなら正確な位置に到達するための余分なサンプルを読み飛ばさないからだ。だが、正確さにかける。 これは速度が重要なときに使用されるべきだ。

This function also updates everything needed within the decoder, so you can immediately call ov_read() and get data from the newly seeked to position.
この関数はデコーダ内部の必要なデータを更新するため、すぐに ov_read() を呼んで新しい位置からのデータを所得できる。

This function does not work for unseekable streams.
この関数は移動不可能なストリームでは動作しない。

int ov_time_seek_page(OggVorbis_File *vf, double s);

Parameters

vf

Pointer to our already opened and initialized OggVorbis_File structure.
すでに開かれ初期化されているOggVorbis_File構造体へのポインタ。

ms

Location to seek to within the file, specified in seconds.
ファイル内で移動したい位置。時間で指定する。

Return Values

0 for success　0は成功を示す

nonzero indicates failure, described by several error codes:　0以外は失敗であり、エラーコードを示す

• OV_ENOSEEK - Bitstream is not seekable.
  OV_ENOSEEK - ビットストリームは移動不可能である
• OV_EINVAL - Invalid argument value.
  OV_EINVAL - 引数の値が無効である
• OV_EREAD - A read from media returned an error.
  OV_EREAD - メディアからの読み込みでエラーが返った
• OV_EFAULT - Internal logic fault; indicates a bug or heap/stack corruption.
  OV_EFAULT - 内部論理エラー。ヒープやスタックの問題、バグを含む。
• OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
  OV_EBADLINK - libvorbisfileに与えたストリームセクションが無効か、要求されたリンクが間違っている。