Document ogg_codec's header function
authorDavid Conrad <lessen42@gmail.com>
Sat, 21 Mar 2009 08:03:30 +0000 (08:03 +0000)
committerDavid Conrad <lessen42@gmail.com>
Sat, 21 Mar 2009 08:03:30 +0000 (08:03 +0000)
Originally committed as revision 18100 to svn://svn.ffmpeg.org/ffmpeg/trunk

libavformat/oggdec.h

index d238e99..1d65ba7 100644 (file)
@@ -31,6 +31,12 @@ struct ogg_codec {
     const int8_t *magic;
     uint8_t magicsize;
     const int8_t *name;
+    /**
+     * Attempt to process a packet as a header
+     * @return 1 if the packet was a valid header,
+     *         0 if the packet was not a header (was a data packet)
+     *         -1 if an error occurred or for unsupported stream
+     */
     int (*header)(AVFormatContext *, int);
     int (*packet)(AVFormatContext *, int);
     uint64_t (*gptopts)(AVFormatContext *, int, uint64_t);