aboutsummaryrefslogtreecommitdiffstats
path: root/libavformat/avformat.h
diff options
context:
space:
mode:
authorMarth64 <marth64@proxyid.net>2024-02-09 16:08:02 -0600
committerMarth64 <marth64@proxyid.net>2025-01-08 00:14:13 -0600
commit910e5a275ddede994697e09fd3b9c7907fd6d15c (patch)
tree35c6f260a62ac6df2d2aa8b890b5e2b1b0404761 /libavformat/avformat.h
parent8ad2d1919fdf8a33f72761799367293bbb379b55 (diff)
downloadffmpeg-910e5a275ddede994697e09fd3b9c7907fd6d15c.tar.gz
avformat/avformat.h: elaborate documentation for avformat_open_input() on error condition
Signed-off-by: Marth64 <marth64@proxyid.net>
Diffstat (limited to 'libavformat/avformat.h')
-rw-r--r--libavformat/avformat.h5
1 files changed, 3 insertions, 2 deletions
diff --git a/libavformat/avformat.h b/libavformat/avformat.h
index cedfd82170..6abdb6d480 100644
--- a/libavformat/avformat.h
+++ b/libavformat/avformat.h
@@ -2296,7 +2296,7 @@ int av_probe_input_buffer(AVIOContext *pb, const AVInputFormat **fmt,
* which case an AVFormatContext is allocated by this
* function and written into ps.
* Note that a user-supplied AVFormatContext will be freed
- * on failure.
+ * on failure and its pointer set to NULL.
* @param url URL of the stream to open.
* @param fmt If non-NULL, this parameter forces a specific input format.
* Otherwise the format is autodetected.
@@ -2305,7 +2305,8 @@ int av_probe_input_buffer(AVIOContext *pb, const AVInputFormat **fmt,
* On return this parameter will be destroyed and replaced with
* a dict containing options that were not found. May be NULL.
*
- * @return 0 on success, a negative AVERROR on failure.
+ * @return 0 on success; on failure: frees ps, sets its pointer to NULL,
+ * and returns a negative AVERROR.
*
* @note If you want to use custom IO, preallocate the format context and set its pb field.
*/