Whole document tree

ov_raw_seek

declared in "vorbis/vorbisfile.h";

Seeks to the offset specified (in compressed raw bytes) within the physical bitstream. This function only works for seekable streams.

This also updates everything needed within the decoder, so you can immediately call ov_read() and get data from the newly seeked to position.

When seek speed is a priority, this is the best vorbisfile seek funtion to use.

int ov_raw_seek(OggVorbis_File *vf,long pos);

Parameters

vf

A pointer to the OggVorbis_File structure--this is used for ALL the externally visible vorbisfile functions. Once this has been called, the same OggVorbis_File struct should be passed to all the vorbisfile functions.

pos

Position in compressed bytes to seek to in the bitstream.

Return Values

0 indicates success

nonzero indicates failure, described by several error codes:

• OV_ENOSEEK - Bitstream is not seekable.
• OV_EINVAL - Invalid argument value.
• OV_EBADLINK - Invalid stream section supplied to libvorbis/libvorbisfile, or the requested link is corrupt.