From: Derek Buitenhuis Date: Mon, 29 Apr 2013 02:13:21 +0000 (-0400) Subject: avcodec: doxy: Clarify what get_buffer2 must fill in buf[] X-Git-Tag: n2.0~26^2~479 X-Git-Url: http://git.ffmpeg.org/gitweb/ffmpeg.git/commitdiff_plain/4cdb3c50b5383850bb900d79e57d23cf22b3214f?ds=sidebyside avcodec: doxy: Clarify what get_buffer2 must fill in buf[] Signed-off-by: Derek Buitenhuis --- diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h index d8e5d5e..c9526c7 100644 --- a/libavcodec/avcodec.h +++ b/libavcodec/avcodec.h @@ -1920,8 +1920,11 @@ typedef struct AVCodecContext { * extended_data must be allocated with av_malloc() and will be freed in * av_frame_unref(). * * otherwise exended_data must point to data - * - buf[] must contain references to the buffers that contain the frame - * data. + * - buf[] must contain one or more pointers to AVBufferRef structures. Each of + * the frame's data and extended_data pointers must be contained in these. That + * is, one AVBufferRef for each allocated chunk of memory, not necessarily one + * AVBufferRef per data[] entry. See: av_buffer_create(), av_buffer_alloc(), + * and av_buffer_ref(). * - extended_buf and nb_extended_buf must be allocated with av_malloc() by * this callback and filled with the extra buffers if there are more * buffers than buf[] can hold. extended_buf will be freed in