libogg documentation | libogg release 1.3.0 - 20110804

# ogg_sync_pageseek

declared in "ogg/ogg.h";

This function synchronizes the ogg_sync_state struct to the next ogg_page.

This is useful when seeking within a bitstream. ogg_sync_pageseek will synchronize to the next page in the bitstream and return information about how many bytes we advanced or skipped in order to do so.

    int ogg_sync_pageseek(ogg_sync_state *oy, ogg_page *og);

### Parameters

oy
  Pointer to a previously declared ogg_sync_state struct.
og
  Pointer to a page (or an incomplete page) of data. This is the page we are attempting to sync.

### Return Values

> - -n means that we skipped n bytes within the bitstream.
> - 0 means that the page isn't ready and we need more data, or than an internal error occurred. No bytes have been skipped.
> - n means that the page was synced at the current location, with a page length of n bytes.

copyright © 2000-2011 Xiph.Org | Ogg Container Format
libogg documentation | libogg release 1.3.0 - 20110804