Skip to content

Commit

Permalink
lavc: clarify get_buffer() documentation
Browse files Browse the repository at this point in the history
This is needed for the AAC decoder, which may need to call get_buffer()
more than once if the channel configuration changes.
  • Loading branch information
justinruggles committed Nov 26, 2012
1 parent 3ffed68 commit 8e134e5
Showing 1 changed file with 6 additions and 1 deletion.
7 changes: 6 additions & 1 deletion libavcodec/avcodec.h
Original file line number Diff line number Diff line change
Expand Up @@ -2218,7 +2218,12 @@ typedef struct AVCodecContext {
*
* Decoders cannot use the buffer after returning from
* avcodec_decode_audio4(), so they will not call release_buffer(), as it
* is assumed to be released immediately upon return.
* is assumed to be released immediately upon return. In some rare cases,
* a decoder may need to call get_buffer() more than once in a single
* call to avcodec_decode_audio4(). In that case, when get_buffer() is
* called again after it has already been called once, the previously
* acquired buffer is assumed to be released at that time and may not be
* reused by the decoder.
*
* As a convenience, av_samples_get_buffer_size() and
* av_samples_fill_arrays() in libavutil may be used by custom get_buffer()
Expand Down

0 comments on commit 8e134e5

Please sign in to comment.