On 2013-06-18 11:38, Anton Khirnov wrote:
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -3982,7 +3982,13 @@ int avcodec_fill_audio_frame(AVFrame *frame, int
nb_channels,
/**
- * Flush buffers, should be called when seeking or when switching to a
different stream.
+ * Reset the internal decoder state / flush internal buffers. Should be called
+ * e.g. when seeking or when switching to a different stream.
+ *
+ * @note when refcounted frames are not used (i.e. avctx->refcounted_frames is
0),
+ * this invalidates the frames previously returned from the decoder. When
+ * refcounted frames are used, the decoder just releases any references it
might
+ * keep internally, but the caller's reference remains valid.
*/
void avcodec_flush_buffers(AVCodecContext *avctx);
LGTM
Please document the function argument while you're at it to get rid of a
Doxygen warning.
Diego
_______________________________________________
libav-devel mailing list
[email protected]
https://lists.libav.org/mailman/listinfo/libav-devel
