1<html> 2 3<head> 4<title>Vorbisfile - function - ov_time_seek</title> 5<link rel=stylesheet href="style.css" type="text/css"> 6</head> 7 8<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff"> 9<table border=0 width=100%> 10<tr> 11<td><p class=tiny>Vorbisfile documentation</p></td> 12<td align=right><p class=tiny>vorbisfile version 1.2.0 - 20070723</p></td> 13</tr> 14</table> 15 16<h1>ov_time_seek</h1> 17 18<p><i>declared in "vorbis/vorbisfile.h";</i></p> 19 20<p>For seekable 21streams, this seeks to the given time. For implementing seeking in a player, 22this is the only function generally needed. This also updates everything needed within the 23decoder, so you can immediately call <a href="ov_read.html">ov_read()</a> and get data from 24the newly seeked to position. This function does not work for unseekable streams. 25 26<br><br> 27<table border=0 color=black cellspacing=0 cellpadding=7> 28<tr bgcolor=#cccccc> 29 <td> 30<pre><b> 31int ov_time_seek(<a href="OggVorbis_File.html">OggVorbis_File</a> *vf, double s); 32</b></pre> 33 </td> 34</tr> 35</table> 36 37<h3>Parameters</h3> 38<dl> 39<dt><i>vf</i></dt> 40<dd>Pointer to our already opened and initialized OggVorbis_File structure.</dd> 41<dt><i>ms</i></dt> 42<dd>Location to seek to within the file, specified in seconds.</dd> 43</dl> 44 45 46<h3>Return Values</h3> 47<blockquote> 48<ul> 49<li>0 for success</li> 50 51<li> 52nonzero indicates failure, described by several error codes: 53 <ul> 54 <li>OV_ENOSEEK - Bitstream is not seekable. 55 </li> 56 <li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open. 57 </li> 58 <li>OV_EREAD - A read from media returned an error. 59 </li> 60 <li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack 61 corruption. 62 </li> 63 <li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt. 64 </li> 65 </ul></li> 66</ul></blockquote> 67 68<br><br> 69<hr noshade> 70<table border=0 width=100%> 71<tr valign=top> 72<td><p class=tiny>copyright © 2007 Xiph.org</p></td> 73<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td> 74</tr><tr> 75<td><p class=tiny>Vorbisfile documentation</p></td> 76<td align=right><p class=tiny>vorbisfile version 1.2.0 - 20070723</p></td> 77</tr> 78</table> 79 80</body> 81 82</html> 83