Describe read_alloc return value and required pkt handling to avoid memleaks

Originally committed as revision 18358 to svn://svn.ffmpeg.org/ffmpeg/trunk
This commit is contained in:
Reimar Döffinger 2009-04-07 21:10:10 +00:00
parent 4e5735f774
commit 6883ebe4b9

View File

@ -249,7 +249,10 @@ typedef struct AVInputFormat {
AVFormatParameters *ap); AVFormatParameters *ap);
/** Read one packet and put it in 'pkt'. pts and flags are also /** Read one packet and put it in 'pkt'. pts and flags are also
set. 'av_new_stream' can be called only if the flag 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); int (*read_packet)(struct AVFormatContext *, AVPacket *pkt);
/** Close the stream. The AVFormatContext and AVStreams are not /** Close the stream. The AVFormatContext and AVStreams are not
freed by this function */ freed by this function */