AVIOContext Struct Reference

Bytestream IO Context. More...

#include <avio.h>

Collaboration diagram for AVIOContext:
Collaboration graph

Data Fields

const AVClassav_class
 A class for private options. More...
 
unsigned char * buffer
 Start of the buffer. More...
 
int buffer_size
 Maximum buffer size. More...
 
unsigned char * buf_ptr
 Current position in the buffer. More...
 
unsigned char * buf_end
 End of the data, may be less than buffer+buffer_size if the read function returned less data than requested, e.g. More...
 
voidopaque
 A private pointer, passed to the read/write/seek/... More...
 
int(* read_packet )(void *opaque, uint8_t *buf, int buf_size)
 
int(* write_packet )(void *opaque, uint8_t *buf, int buf_size)
 
int64_t(* seek )(void *opaque, int64_t offset, int whence)
 
int64_t pos
 position in the file of the current buffer More...
 
int must_flush
 true if the next seek should flush More...
 
int eof_reached
 true if eof reached More...
 
int write_flag
 true if open for writing More...
 
int max_packet_size
 
unsigned long checksum
 
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 More...
 
int(* read_pause )(void *opaque, int pause)
 Pause or resume playback for network streaming protocols - e.g. More...
 
int64_t(* read_seek )(void *opaque, int stream_index, int64_t timestamp, int flags)
 Seek to a given timestamp in stream with the specified stream_index. More...
 
int seekable
 A combination of AVIO_SEEKABLE_ flags or 0 when the stream is not seekable. More...
 
int64_t maxsize
 max filesize, used to limit allocations This field is internal to libavformat and access from outside is not allowed. More...
 
int direct
 avio_read and avio_write should if possible be satisfied directly instead of going through a buffer, and avio_seek will always call the underlying seek function directly. More...
 
int64_t bytes_read
 Bytes read statistic This field is internal to libavformat and access from outside is not allowed. More...
 
int seek_count
 seek statistic This field is internal to libavformat and access from outside is not allowed. More...
 
int writeout_count
 writeout statistic This field is internal to libavformat and access from outside is not allowed. More...
 

Detailed Description

Bytestream IO Context.

New fields can be added to the end with minor version bumps. 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()

Definition at line 68 of file avio.h.

Field Documentation

const AVClass* AVIOContext::av_class

A class for private options.

If this AVIOContext is created by avio_open2(), av_class is set and passes the options down to protocols.

If this AVIOContext is manually allocated, then av_class may be set by the caller.

warning – this field can be NULL, be sure to not pass this AVIOContext to any av_opt_* functions in that case.

Definition at line 81 of file avio.h.

Referenced by av_probe_input_buffer(), and format_child_next().

unsigned char* AVIOContext::buf_end

End of the data, may be less than buffer+buffer_size if the read function returned less data than requested, e.g.

for streams where no more data has been received yet.

Definition at line 85 of file avio.h.

Referenced by avio_r8(), avio_read(), avio_seek(), avio_seek_time(), avio_w8(), avio_write(), ffio_fill(), ffio_init_context(), ffio_read_partial(), ffio_rewind_with_probe_data(), fill_buffer(), hls_read_seek(), init_packetizer(), read_gab2_sub(), and url_resetbuf().

int AVIOContext::buffer_size
int64_t AVIOContext::bytes_read

Bytes read statistic This field is internal to libavformat and access from outside is not allowed.

Definition at line 136 of file avio.h.

Referenced by avio_close(), avio_read(), and fill_buffer().

unsigned long AVIOContext::checksum

Definition at line 99 of file avio.h.

Referenced by ffio_get_checksum(), ffio_init_checksum(), fill_buffer(), and flush_buffer().

unsigned char* AVIOContext::checksum_ptr

Definition at line 100 of file avio.h.

Referenced by ffio_get_checksum(), ffio_init_checksum(), fill_buffer(), and flush_buffer().

int AVIOContext::direct

avio_read and avio_write should if possible be satisfied directly instead of going through a buffer, and avio_seek will always call the underlying seek function directly.

Definition at line 130 of file avio.h.

Referenced by avio_read(), avio_seek(), avio_write(), and ffio_init_context().

int AVIOContext::max_packet_size

Definition at line 98 of file avio.h.

Referenced by avio_close_dyn_buf(), ffio_init_context(), fill_buffer(), and rtp_write_header().

int64_t AVIOContext::maxsize

max filesize, used to limit allocations This field is internal to libavformat and access from outside is not allowed.

Definition at line 123 of file avio.h.

Referenced by append_packet_chunked(), ffio_limit(), mp3_read_header(), and thp_read_header().

int AVIOContext::must_flush

true if the next seek should flush

Definition at line 95 of file avio.h.

Referenced by avio_flush(), avio_seek(), ffio_init_context(), and ffio_rewind_with_probe_data().

void* AVIOContext::opaque
int(* AVIOContext::read_packet) (void *opaque, uint8_t *buf, int buf_size)

Definition at line 91 of file avio.h.

Referenced by avio_read(), ffio_init_context(), ffio_read_partial(), and fill_buffer().

int(* AVIOContext::read_pause) (void *opaque, int pause)

Pause or resume playback for network streaming protocols - e.g.

MMS.

Definition at line 106 of file avio.h.

Referenced by avio_pause(), and ffio_init_context().

int64_t(* AVIOContext::read_seek) (void *opaque, int stream_index, int64_t timestamp, int flags)

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.

Definition at line 112 of file avio.h.

Referenced by avio_seek_time(), and ffio_init_context().

int64_t(* AVIOContext::seek) (void *opaque, int64_t offset, int whence)

Definition at line 93 of file avio.h.

Referenced by avio_seek(), avio_seek_time(), avio_size(), ffio_init_context(), and nut_read_header().

int AVIOContext::seek_count

seek statistic This field is internal to libavformat and access from outside is not allowed.

Definition at line 142 of file avio.h.

Referenced by avio_close(), and avio_seek().

int AVIOContext::seekable

A combination of AVIO_SEEKABLE_ flags or 0 when the stream is not seekable.

Definition at line 117 of file avio.h.

Referenced by aiff_read_header(), aiff_write_trailer(), amf_parse_object(), ape_read_header(), asf_write_header1(), asf_write_trailer(), ast_write_trailer(), avi_read_header(), avi_write_header(), avi_write_idx1(), avi_write_ix(), avi_write_packet(), avi_write_trailer(), avio_seek(), caf_write_header(), caf_write_trailer(), dv_read_header(), estimate_timings(), ff_id3v1_read(), ff_voc_get_packet(), ffio_init_context(), ffm2_read_header(), ffm_read_header(), flac_write_trailer(), flv_read_packet(), gxf_write_header(), hls_read_header(), http_prepare_data(), http_receive_data(), ico_write_header(), init_stream(), matroska_execute_seekhead(), mkv_write_header(), mkv_write_packet(), mkv_write_packet_internal(), mkv_write_trailer(), mmf_rate(), mov_find_next_sample(), mov_read_default(), mov_read_header(), mov_write_header(), mov_write_trailer(), mp3_read_header(), mp3_write_xing(), mpc8_read_header(), mpc_read_header(), mpegps_read_pes_header(), mpegts_read_header(), mv_read_packet(), mv_read_seek(), mxf_parse_handle_essence(), mxf_write_footer(), nut_read_header(), ogg_get_length(), ogg_read_page(), ogg_replace_stream(), put_id3v2_tags(), r3d_read_header(), read_header(), read_seek(), rm_read_header(), rm_write_trailer(), rso_write_header(), rv10_write_header(), smjpeg_write_trailer(), sox_write_trailer(), swf_write_trailer(), tak_read_header(), vc1test_write_trailer(), write_trailer(), wv_read_block_header(), and wv_read_header().

unsigned long(* AVIOContext::update_checksum) (unsigned long checksum, const uint8_t *buf, unsigned int size)
int AVIOContext::write_flag

true if open for writing

Definition at line 97 of file avio.h.

Referenced by avio_close(), avio_read(), avio_seek(), ffio_read_partial(), ffio_rewind_with_probe_data(), ffio_set_buf_size(), and url_resetbuf().

int(* AVIOContext::write_packet) (void *opaque, uint8_t *buf, int buf_size)

Definition at line 92 of file avio.h.

Referenced by ffio_init_context(), and writeout().

int AVIOContext::writeout_count

writeout statistic This field is internal to libavformat and access from outside is not allowed.

Definition at line 148 of file avio.h.

Referenced by avio_close(), and writeout().


The documentation for this struct was generated from the following file: