4 <title>Tremor - function - ov_pcm_seek_page
</title>
5 <link rel=stylesheet
href=
"style.css" type=
"text/css">
8 <body bgcolor=white text=black
link=
"#5555ff" alink=
"#5555ff" vlink=
"#5555ff">
9 <table border=
0 width=
100%
>
11 <td><p class=tiny
>Tremor documentation
</p></td>
12 <td align=right
><p class=tiny
>Tremor version
1.0 -
20020403</p></td>
16 <h1>ov_pcm_seek_page
</h1>
18 <p><i>declared in
"ivorbisfile.h";
</i></p>
20 <p>Seeks to the closest page preceding the specified location (in pcm samples) within the physical bitstream. This function only works for seekable streams.
21 <p>This function is faster than
<a href=
"ov_pcm_seek.html">ov_pcm_seek
</a> 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.
22 <p>This also updates everything needed within the
23 decoder, so you can immediately call
<a href=
"ov_read.html">ov_read()
</a> and get data from
24 the newly seeked to position.
28 <table border=
0 color=black cellspacing=
0 cellpadding=
7>
32 int ov_pcm_seek_page(OggVorbis_File *vf,ogg_int64_t pos);
41 <dd>A pointer to the OggVorbis_File structure--this is used for ALL the externally visible libvorbisidec
44 <dd>Position in pcm samples to seek to in the bitstream.
</dd>
48 <h3>Return Values
</h3>
54 nonzero indicates failure, described by several error codes:
</li>
56 <li>OV_ENOSEEK - Bitstream is not seekable.
58 <li>OV_EINVAL - Invalid argument value.
60 <li>OV_EREAD - A read from media returned an error.
62 <li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
65 <li>OV_EBADLINK - Invalid stream section supplied to libvorbisidec, or the requested link is corrupt.
71 <table border=
0 width=
100%
>
73 <td><p class=tiny
>copyright
© 2002 Xiph.org
</p></td>
74 <td align=right
><p class=tiny
><a href=
"http://www.xiph.org/ogg/vorbis/">Ogg Vorbis
</a></p></td>
76 <td><p class=tiny
>Tremor documentation
</p></td>
77 <td align=right
><p class=tiny
>Tremor version
1.0 -
20020403</p></td>