RepoMirrors
/
ffmpeg
mirror of https://git.ffmpeg.org/ffmpeg.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

buffersink: document special error codes returned from av_buffersink_get_frame

This commit is contained in:
Anton Khirnov 2013-05-21 20:30:36 +02:00
parent 98fdfa9970
commit f758ea6e99
1 changed files with 9 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
libavfilter/buffersink.h
View File

@ -70,8 +70,12 @@ int av_buffersink_read_samples(AVFilterContext *ctx, AVFilterBufferRef **buf,
* @param frame pointer to an allocated frame that will be filled with data. * @param frame pointer to an allocated frame that will be filled with data.
* The data must be freed using av_frame_unref() / av_frame_free() * The data must be freed using av_frame_unref() / av_frame_free()
* *
* @return >= 0 in case of success, a negative AVERROR code in case of * @return
* failure. * - >= 0 if a frame was successfully returned.
* - AVERROR(EAGAIN) if no frames are available at this point; more
* input frames must be added to the filtergraph to get more output.
* - AVERROR_EOF if there will be no more output frames on this sink.
* - A different negative AVERROR code in other failure cases.
*/ */
int av_buffersink_get_frame(AVFilterContext *ctx, AVFrame *frame); int av_buffersink_get_frame(AVFilterContext *ctx, AVFrame *frame);
@ -86,6 +90,9 @@ int av_buffersink_get_frame(AVFilterContext *ctx, AVFrame *frame);
* frame will contain exactly nb_samples audio samples, except at * frame will contain exactly nb_samples audio samples, except at
* the end of stream, when it can contain less than nb_samples. * the end of stream, when it can contain less than nb_samples.
* *
* @return The return codes have the same meaning as for
* av_buffersink_get_samples().
*
* @warning do not mix this function with av_buffersink_get_frame(). Use only one or * @warning do not mix this function with av_buffersink_get_frame(). Use only one or
* the other with a single sink, not both. * the other with a single sink, not both.
*/ */