vorbisfile - function - ov_time_seek_page

vorbisfile documentation | vorbisfile version 1.25 - 20000615

# ov_time_seek_page

declared in "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.

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.

For obvious reasons, this doesn't work for unseekable streams.

    int ov_time_seek_page(OggVorbis_File *vf, double seconds);

### Parameters

vf
  Pointer to our already opened and initialized OggVorbis_File structure.
seconds
  Location to seek to within the file, specified in seconds.

### Return Values

> - 0 for success
> - nonzero indicates failure, described by several error codes:
> - OV_ENOSEEK - Bitstream is not seekable.
> - OV_EINVAL - Invalid argument value.
> - OV_EREAD - A read from media returned an error.
> - OV_EFAULT - Internal logic fault; indicates a bug or heap/stack corruption.
> - OV_EBADLINK - Invalid stream section supplied to libvorbis/libvorbisfile, or the requested link is corrupt.

copyright © 2000 vorbis team | Ogg Vorbis team@vorbis.org
vorbisfile documentation | vorbisfile version 1.25 - 20000615