FFMpeg学习笔记 AVFormatContext结构分析

</pre>直接贴代码！AVFormatContext<pre name="code" class="cpp">typedef struct AVFormatContext {
/*
AVFormatContext包含码流参数较多。主要储存音视频封装格式中的信息
*/
const AVClass *av_class;
//下面二者只能出现一个，不能同时出现
//解码时下面两项由avformat_open_input()来确定
//编码时由用户来决定
struct AVInputFormat *iformat;
struct AVOutputFormat *oformat;
//私有格式数据，这是一个能被--enable选择的类型
//当且仅当iformat或者oformat存在时，priv_data不为空
void *priv_data;
//I/O内容,输入数据的缓存
//解码时在avformt_open_input()之前由用户设定(用户也得手动的关闭)
//编码时也是由用户来指定
//当AVFMT_NOFILE的flag在iformat/oformat.flag中被设定的时候，
//此项为空。在这种情况下，（解）复用器将会处理
//在某些情况，此段也会为空。
AVIOContext *pb;
//特别的格式标志，如:AVFMTCTX_XX
int ctx_flags;

//文件中码流表，又avformat_new_stream来建立
//解码时，stream由libavformat的avformat_open_input()函数来建立
//出现av_read_frame()中
//编码时，streams由用户在avformat+write+header()来建立
unsigned int nb_streams;//视音频流的个数
AVStream **streams;//视音频流（重要）

char filename[1024];//输入或者输出的filename
//解码时，第一帧位置，在AV_TIME_BASE的小数秒钟。
//永远不要直接的来设置start_time的值。
//它是由AVStream的值来推断出来的
int64_t start_time;
//解码时，stream的持续时间在AV_TIME_BASE的小数位
//只有在知道没有任何stream持续时间且没对他们做任何设置的时候
//才对duration赋值
int64_t duration;
//解码时，整个stream的比特率，如果时available，其为0.
//不要直接设置它的值，因为如果文件大小和持续时间是已知的，
//FFmpeg会自动计算它。
int bit_rate;

unsigned int packet_size;
int max_delay;

int flags;
#define AVFMT_FLAG_GENPTS       0x0001 ///< Generate missing pts even if it requires parsing future frames.
#define AVFMT_FLAG_IGNIDX       0x0002 ///< Ignore index.
#define AVFMT_FLAG_NONBLOCK     0x0004 ///< Do not block when reading packets from input.
#define AVFMT_FLAG_IGNDTS       0x0008 ///< Ignore DTS on frames that contain both DTS & PTS
#define AVFMT_FLAG_NOFILLIN     0x0010 ///< Do not infer any values from other values, just return what is stored in the container
#define AVFMT_FLAG_NOPARSE      0x0020 ///< Do not use AVParsers, you also must set AVFMT_FLAG_NOFILLIN as the fillin code works on frames and no parsing -> no frames. Also seeking to frames can not work if parsing to find frame boundaries has been disabled
#define AVFMT_FLAG_NOBUFFER     0x0040 ///< Do not buffer frames when possible
#define AVFMT_FLAG_CUSTOM_IO    0x0080 ///< The caller has supplied a custom AVIOContext, don't avio_close() it.
#define AVFMT_FLAG_DISCARD_CORRUPT  0x0100 ///< Discard frames marked corrupted
#define AVFMT_FLAG_FLUSH_PACKETS    0x0200 ///< Flush the AVIOContext every packet.

#define AVFMT_FLAG_BITEXACT         0x0400
#define AVFMT_FLAG_MP4A_LATM    0x8000 ///< Enable RTP MP4A-LATM payload
#define AVFMT_FLAG_SORT_DTS    0x10000 ///< try to interleave outputted packets by dts (using this flag can slow demuxing down)
#define AVFMT_FLAG_PRIV_OPT    0x20000 ///< Enable use of private options by delaying codec open (this could be made default once all code is converted)
#define AVFMT_FLAG_KEEP_SIDE_DATA 0x40000 ///< Don't merge side data but keep it separate.
#define AVFMT_FLAG_FAST_SEEK   0x80000 ///< Enable fast, but inaccurate seeks for some formats

#if FF_API_PROBESIZE_32
//解码时，probe的数据大小，解码时不会用到此项
unsigned int probesize;

attribute_deprecated
//解码时，在最大时间（在AV_TIME_BASE里）内
//输入被avformat_find_stream_info()解析
int max_analyze_duration;
#endif

const uint8_t *key;
int keylen;

unsigned int nb_programs;
AVProgram **programs;
//音视频的编解码器ID
//解复用时:由用户指定
enum AVCodecID video_codec_id;
enum AVCodecID audio_codec_id;

enum AVCodecID subtitle_codec_id;
//最大的bytes用于stream的索引，如果超过这个大小，入口将会拒绝
//需要分配一个更小的大小，这可能会导致更慢或者更加不精准的搜索（决定与解复用器）
//muxing：不用此项
//demuxing：用户指定
unsigned int max_index_size;
//最大的bytes用于由实时捕获设备的帧缓存。
unsigned int max_picture_buffer;

unsigned int nb_chapters;
AVChapter **chapters;

AVDictionary *metadata;//元数据
//stream的实际时间，此时pts=0.
//解码时，不用
//编码时：由用户指定
int64_t start_time_realtime;

int fps_probe_size;

int error_recognition;

AVIOInterruptCB interrupt_callback;

int debug;
#define FF_FDEBUG_TS        0x0001

int64_t max_interleave_delta;

int strict_std_compliance;

int event_flags;
#define AVFMT_EVENT_FLAG_METADATA_UPDATED 0x0001 ///< The call resulted in updated metadata.

int max_ts_probe;

int avoid_negative_ts;
#define AVFMT_AVOID_NEG_TS_AUTO             -1 ///< Enabled when required by target format
#define AVFMT_AVOID_NEG_TS_MAKE_NON_NEGATIVE 1 ///< Shift timestamps so they are non negative
#define AVFMT_AVOID_NEG_TS_MAKE_ZERO         2 ///< Shift timestamps so that they start at 0

//变换的stream id
int ts_id;
//音频的预载，时间单位位微秒
int audio_preload;
//最大的块时间，微秒
//并不是所有的格式都支持
int max_chunk_duration;
//最大的块大小，bytes
int max_chunk_size;

int use_wallclock_as_timestamps;

int avio_flags;

enum AVDurationEstimationMethod duration_estimation_method;

int64_t skip_initial_bytes;

unsigned int correct_ts_overflow;

int seek2any;

int flush_packets;

int probe_score;

int format_probesize;

char *codec_whitelist;

char *format_whitelist;

AVFormatInternal *internal;

int io_repositioned;

AVCodec *video_codec;

AVCodec *audio_codec;

AVCodec *subtitle_codec;

AVCodec *data_codec;

int metadata_header_padding;
void *opaque;

av_format_control_message control_message_cb;
//输出时的时间戳便宜，微秒
//不能直接设置
int64_t output_ts_offset;

#if FF_API_PROBESIZE_32
int64_t max_analyze_duration2;
#else
int64_t max_analyze_duration;
#endif

#if FF_API_PROBESIZE_32
int64_t probesize2;
#else
int64_t probesize;
#endif
uint8_t *dump_separator;

enum AVCodecID data_codec_id;

int (*open_cb)(struct AVFormatContext *s, AVIOContext **p, const char *url, int flags, const AVIOInterruptCB *int_cb, AVDictionary **options);
} AVFormatContext;