diff options
author | Anton Khirnov <anton@khirnov.net> | 2011-04-10 08:14:26 +0200 |
---|---|---|
committer | Anton Khirnov <anton@khirnov.net> | 2011-04-10 14:31:49 +0200 |
commit | d1c5fdf8920b75f3b824368b8336f18c74b68803 (patch) | |
tree | cb87be8b38140198c8385229c73bba477700fbbf | |
parent | 768c5251141be705d64a480b641c6b17d32a4e7b (diff) | |
download | ffmpeg-d1c5fdf8920b75f3b824368b8336f18c74b68803.tar.gz |
avio: add more documentation for AVIOContext.
-rw-r--r-- | libavformat/avio.h | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/libavformat/avio.h b/libavformat/avio.h index 95cad17787..7e7e429117 100644 --- a/libavformat/avio.h +++ b/libavformat/avio.h @@ -41,6 +41,11 @@ * Removal, reordering and changes to existing fields require a major * version bump. * sizeof(AVIOContext) must not be used outside libav*. + * + * @note None of the function pointers in AVIOContext should be called + * directly, they should only be set by the client application + * when implementing custom I/O. Normally these are set to the + * function pointers specified in avio_alloc_context() */ typedef struct { unsigned char *buffer; /**< Start of the buffer. */ @@ -67,7 +72,15 @@ typedef struct { unsigned char *checksum_ptr; unsigned long (*update_checksum)(unsigned long checksum, const uint8_t *buf, unsigned int size); int error; /**< contains the error code or 0 if no error happened */ + /** + * Pause or resume playback for network streaming protocols - e.g. MMS. + */ int (*read_pause)(void *opaque, int pause); + /** + * Seek to a given timestamp in stream with the specified stream_index. + * Needed for some network streaming protocols which don't support seeking + * to byte position. + */ int64_t (*read_seek)(void *opaque, int stream_index, int64_t timestamp, int flags); /** |