libogg documentation

libogg release 1.2.0 - 20100325

ogg_stream_iovecin

declared in "ogg/ogg.h";

This function submits packet data (in the form of an array of ogg_iovec_t, rather than using an ogg_packet structure) to the bitstream for page encapsulation. After this is called, more packets can be submitted, or pages can be written out.

In a typical encoding situation, this should be used after filling a packet with data. The data in the packet is copied into the internal storage managed by the ogg_stream_state, so the caller is free to alter the contents of os after this call has returned.


int ogg_stream_iovecin(ogg_stream_state *os, ogg_iovec_t *iov, int count, long e_o_s, ogg_int64_t granulepos);

Parameters

os
Pointer to a previously declared ogg_stream_state struct.
iov
Length-encoded buffers held in an array of ogg_iovec_t.
count
Length of the iov array.
e_o_s
End of stream flag, analagous to the e_o_s field in an ogg_packet.
granulepos
Granule position value, analagous to the granpos field in an ogg_packet.

Return Values

  • 0 returned on success. -1 returned in the event of internal error.



  • copyright © 2000-2010 Xiph.Org

    Ogg Container Format

    libogg documentation

    libogg release 1.2.0 - 20100325