From 1305d93c42946ef524c1cdc927a7e66eec510005 Mon Sep 17 00:00:00 2001 From: Anton Khirnov Date: Mon, 4 Apr 2011 19:48:31 +0200 Subject: avio: deprecate av_url_read_seek It's not used anywhere internally. Salvage its documentation for ffio_read_seek. --- libavformat/avio_internal.h | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'libavformat/avio_internal.h') diff --git a/libavformat/avio_internal.h b/libavformat/avio_internal.h index db3b308..5ef4cca 100644 --- a/libavformat/avio_internal.h +++ b/libavformat/avio_internal.h @@ -72,6 +72,23 @@ int ffio_set_buf_size(AVIOContext *s, int buf_size); * @param pause 1 for pause, 0 for resume */ int ffio_read_pause(AVIOContext *h, int pause); +/** + * Seek to a given timestamp relative to some component stream. + * Only meaningful if using a network streaming protocol (e.g. MMS.). + * @param stream_index The stream index that the timestamp is relative to. + * If stream_index is (-1) the timestamp should be in AV_TIME_BASE + * units from the beginning of the presentation. + * If a stream_index >= 0 is used and the protocol does not support + * seeking based on component streams, the call will fail with ENOTSUP. + * @param timestamp timestamp in AVStream.time_base units + * or if there is no stream specified then in AV_TIME_BASE units. + * @param flags Optional combination of AVSEEK_FLAG_BACKWARD, AVSEEK_FLAG_BYTE + * and AVSEEK_FLAG_ANY. The protocol may silently ignore + * AVSEEK_FLAG_BACKWARD and AVSEEK_FLAG_ANY, but AVSEEK_FLAG_BYTE will + * fail with ENOTSUP if used and not supported. + * @return >= 0 on success + * @see AVInputFormat::read_seek + */ int64_t ffio_read_seek (AVIOContext *h, int stream_index, int64_t timestamp, int flags); -- cgit v1.1