Describe read_alloc return value and required pkt handling to avoid memleaks
authorReimar Döffinger <Reimar.Doeffinger@gmx.de>
Tue, 7 Apr 2009 21:10:10 +0000 (21:10 +0000)
committerReimar Döffinger <Reimar.Doeffinger@gmx.de>
Tue, 7 Apr 2009 21:10:10 +0000 (21:10 +0000)
Originally committed as revision 18358 to svn://svn.ffmpeg.org/ffmpeg/trunk

libavformat/avformat.h

index f30c37e..128ecc5 100644 (file)
@@ -249,7 +249,10 @@ typedef struct AVInputFormat {
                        AVFormatParameters *ap);
     /** Read one packet and put it in 'pkt'. pts and flags are also
        set. 'av_new_stream' can be called only if the flag
-       AVFMTCTX_NOHEADER is used. */
+       AVFMTCTX_NOHEADER is used.
+       @return 0 on success, < 0 on error.
+               When returning an error, pkt must not have been allocated
+               or must be freed before returning */
     int (*read_packet)(struct AVFormatContext *, AVPacket *pkt);
     /** Close the stream. The AVFormatContext and AVStreams are not
        freed by this function */