ov_pcm_seek_page

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

Seeks to the closest page preceding the specified location (in pcm samples) within the physical bitstream. This function only works for seekable streams.
物理ビットストリーム内の指定した位置（PCMサンプルによる位置）に先行する最も近いページへ移動する。 この関数は移動可能なストリームでのみ動作する。

This function is faster than ov_pcm_seek because the function can begin decoding at a page boundary rather than seeking through any remaining samples before the specified location. However, it is less accurate.
この関数は ov_pcm_seek に比べて高速である。なぜなら指定した位置より前の余分なサンプルを読み飛ばすのではなくページ境界からデコードを開始することができためだ。しかしながら、正確さにかける。

This 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() を呼んで新しい位置からのデータを所得できる。

int ov_pcm_seek_page(OggVorbis_File *vf,ogg_int64_t pos);

Parameters

vf

A pointer to the OggVorbis_File structure--this is used for ALL the externally visible libvorbisfile functions.
OggVorbis_File構造体へのポインタ。 これはすべての対外的に可視であるlibvorbisfileの関数で使用される。

pos

Position in pcm samples to seek to in the bitstream.
ビットストリーム内で移動したいPCMサンプル位置。

Return Values

0 indicates 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に与えたストリームセクションが無効か、要求されたリンクが間違っている。