AVFormatContext結構體分析

typedef struct AVFormatContext {
    /**
         * A class for logging and @ref avoptions. Set by avformat_alloc_context().
    處理視頻開始的類，用avformat_alloc_context()分配空間
    *Exports (de)muxer private options if they exist.
    muxer的做用式是將視頻文件、音頻文件和字幕文件合併爲某一個視頻格式
    demuxer的做用估計就是相反吧
    若是存在(de)muxer,那麼他們就是這個類的私有成員
         */
        const AVClass *av_class;

        /**
         * The input container format.
         *這裏說的輸入容器格式應該就是咱們常見的視頻格式吧
         * Demuxing only, set by avformat_open_input().
         *只存在demuxer，那麼就只能用avformat_open_input函數打開視頻*/
        struct AVInputFormat *iformat;

        /**
         * The output container format.
         *這個和上面說的差很少，一個輸入一個輸出
         *Muxing only, must be set by the caller before avformat_write_header().
    要輸出視頻的話，確定是要吧視頻流，音頻流，字幕合起來啦         
    */
        struct AVOutputFormat *oformat;

        /**
         * Format private data. This is an AVOptions-enabled struct
    格式化私有數據？不知所云         
    * if and only if iformat/oformat.priv_class is not NULL.
    當且僅當iformat/oformat.priv_class這個東西非空，這是要幹嗎      
    *
         * - muxing: set by avformat_write_header()
         * - demuxing: set by avformat_open_input()
         */
        void *priv_data;//這是一個能夠指向任何類型數據的指針，不知道用來幹嗎

        /**
         * I/O context.
    輸入/輸出上下文，這是什麼東西，還上下文，真搞不懂。         
    *
         * - demuxing: either set by the user before avformat_open_input() (then
         *             the user must close it manually) or set by avformat_open_input().
    demuxing能夠用兩種方法來初始化，第一種，在調用avformat_open_input()以前初始化，
    這時候就要注意，必定要手動關閉demuxing，第二種就是用avformat_open_input()函數來
    初始化
    * - muxing: set by the user before avformat_write_header(). The caller must
         *           take care of closing / freeing the IO context.
         *
    muxing，要在使用avformat_write_header()以前初始化，而且要記住關閉和釋放IO Context
         * Do NOT set this field if AVFMT_NOFILE flag is set in
    若是AVFMT_NOFILE標誌處於激活狀態的話，就不能初始化這個結構體。
         * iformat/oformat.flags. In such a case, the (de)muxer will handle
    
         * I/O in some other way and this field will be NULL.
    這個IO結構體的使用是有條件的，條件不知足的話，這個結構體指針就指向NULL         
    */
        AVIOContext *pb;

        /* stream info *///這一段是流信息部分
        /**
         * Flags signalling stream properties. A combination of AVFMTCTX_*.
    標記信號傳輸流的屬性
         * Set by libavformat.
         */
        int ctx_flags;

        /**
         * Number of elements in AVFormatContext.streams.
         *
    AVFormatContext.streams中元素的數量，這裏的元素應該是視頻流和音頻流吧
         * Set by avformat_new_stream(), must not be modified by any other code.
    這個成員是用avformat_new_stream()函數初始化，而且不能被其餘代碼修改
         */
        unsigned int nb_streams;
        /**
         * A list of all streams in the file. New streams are created with
         * avformat_new_stream().
    全部的流都在這個結構體中，新的流也能夠經過avformat_new_stream()
    這個函數加入其中
         *
         * - demuxing: streams are created by libavformat in avformat_open_input().
         *             If AVFMTCTX_NOHEADER is set in ctx_flags, then new streams may also
         *             appear in av_read_frame().
    在解複用的時候還能夠經過avformat_open_input()函數把新的流加到結構體中，而且
    在使用ac_read_frame()函數的時候還可能獲得新加入的流
         * - muxing: streams are created by the user before avformat_write_header().
    在複用打包的時候，新的流也能夠利用acformat_write_header()函數寫入到結構體中
         *
         * Freed by libavformat in avformat_free_context().
    用avformat_free_context()函數釋放內存
         */
        AVStream **streams;

        /**
         * input or output filename
    這是輸入輸出文件的文件名
         *
         * - demuxing: set by avformat_open_input()
    解複用的時候，用avformat_open_input()函數初始化
         * - muxing: may be set by the caller before avformat_write_header()
    複用打包的時候用avformat_write_header()函數初始化
         */
        char filename[1024];

        /**
         * Position of the first frame of the component, in
         * AV_TIME_BASE fractional seconds. NEVER set this value directly:
         * It is deduced from the AVStream values.
    這裏說的是整個視頻流中的第一幀的有關信息，可是不知道是第一幀的位置信息呢
    仍是取第一幀的時間信息，估計是時間信息，也不知道是怎麼來的。
         *
         * Demuxing only, set by libavformat.
    只有在解複用的時候纔有用，實現函數在libacformat庫中
         */
        int64_t start_time;

        /**
         * Duration of the stream, in AV_TIME_BASE fractional
         * seconds. Only set this value if you know none of the individual stream
         * durations and also do not set any of them. This is deduced from the
         * AVStream values if not set.
    這應該是解複用時候的流的持續時間，具體什麼意思，還不清楚
         *
         * Demuxing only, set by libavformat.
         */
        int64_t duration;

        /**
         * Total stream bitrate in bit/s, 0 if not
         * available. Never set it directly if the file_size and the
         * duration are known as FFmpeg can compute it automatically.
    這個說的應該說的是視頻的傳播速度，也就是所謂的比特率
         */
        int bit_rate;

        unsigned int packet_size;
        int max_delay;

        /**
         * Flags modifying the (de)muxer behaviour. A combination of AVFMT_FLAG_*.
         * Set by the user before avformat_open_input() / avformat_write_header().
    修改複用（解複用）行爲的標識         
    */
        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.
    /**
     * When muxing, try to avoid writing any random/volatile data to the output.
    * This includes any random IDs, real-time timestamps/dates, muxer version, etc.
     *
    在複用打包的時候儘可能避免寫入其餘的隨機數據
     * This flag is mainly intended for testing.
     */
    #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.

        /**
         * Maximum size of the data read from input for determining
         * the input container format.
    解複用時候從文件中讀出數據包的最大大小
         * Demuxing only, set by the caller before avformat_open_input().
         */
        unsigned int probesize;

        /**
         * @deprecated deprecated in favor of max_analyze_duration2
         */
        attribute_deprecated
        int max_analyze_duration;

        const uint8_t *key;
        int keylen;

        unsigned int nb_programs;
        AVProgram **programs;

        /**
         * Forced video codec_id.
         * Demuxing: Set by user.
    視頻編解碼器的位置
         */
        enum AVCodecID video_codec_id;

        /**
         * Forced audio codec_id.
         * Demuxing: Set by user.
    音頻編解碼器的位置
         */
        enum AVCodecID audio_codec_id;

        /**
         * Forced subtitle codec_id.
         * Demuxing: Set by user.
    字幕編解碼器的位置
         */
        enum AVCodecID subtitle_codec_id;

        /**
         * Maximum amount of memory in bytes to use for the index of each stream.
         * If the index exceeds this size, entries will be discarded as
         * needed to maintain a smaller size. This can lead to slower or less
         * accurate seeking (depends on demuxer).
         * Demuxers for which a full in-memory index is mandatory will ignore
         * this.
         * - muxing: unused
         * - demuxing: set by user
    這個沒怎麼看懂
         */
        unsigned int max_index_size;

        /**
         * Maximum amount of memory in bytes to use for buffering frames
         * obtained from realtime capture devices.
    這個和上面的意思差很少，都是限定上限吧
         */
        unsigned int max_picture_buffer;

        /**
         * Number of chapters in AVChapter array.
         * When muxing, chapters are normally written in the file header,
         * so nb_chapters should normally be initialized before write_header
         * is called. Some muxers (e.g. mov and mkv) can also write chapters
         * in the trailer.  To write chapters in the trailer, nb_chapters
         * must be zero when write_header is called and non-zero when
         * write_trailer is called.
         * - muxing: set by user
         * - demuxing: set by libavformat
    徹底沒看懂什麼意思
         */
        unsigned int nb_chapters;
        AVChapter **chapters;

        /**
         * Metadata that applies to the whole file.
         *
         * - demuxing: set by libavformat in avformat_open_input()
         * - muxing: may be set by the caller before avformat_write_header()
         *
        * Freed by libavformat in avformat_free_context().
    什麼元數據，沒看懂。
         */
        AVDictionary *metadata;

        /**
         * Start time of the stream in real world time, in microseconds
         * since the Unix epoch (00:00 1st January 1970). That is, pts=0 in the
         * stream was captured at this real world time.
         * - muxing: Set by the caller before avformat_write_header(). If set to
         *           either 0 or AV_NOPTS_VALUE, then the current wall-time will
         *           be used.
         * - demuxing: Set by libavformat. AV_NOPTS_VALUE if unknown. Note that
         *             the value may become known after some number of frames
         *             have been received.
    這個是複用或者解複用開始的時間，計時的標準是unix標準
         */
        int64_t start_time_realtime;

        /**
         * The number of frames used for determining the framerate in
         * avformat_find_stream_info().
         * Demuxing only, set by the caller before avformat_find_stream_info().
    這個參數估計是和幀率有關係的。
         */
        int fps_probe_size;

        /**
         * Error recognition; higher values will detect more errors but may
         * misdetect some more or less valid parts as errors.
         * Demuxing only, set by the caller before avformat_open_input().
    這兒應該是打開文件時候報錯用的。
         */
        int error_recognition;

        /**
        * Custom interrupt callbacks for the I/O layer.
         *
         * demuxing: set by the user before avformat_open_input().
         * muxing: set by the user before avformat_write_header()
         * (mainly useful for AVFMT_NOFILE formats). The callback
         * should also be passed to avio_open2() if it's used to
         * open the file.
    這個不知道是什麼。
         */
        AVIOInterruptCB interrupt_callback;

        /**
         * Flags to enable debugging.
    有能力的debug的標識，布吉島神馬一系。
         */
        int debug;
    #define FF_FDEBUG_TS        0x0001

        /**
         * Maximum buffering duration for interleaving.
    掃描緩衝區最大持續時間
         *
         * To ensure all the streams are interleaved correctly,
         * av_interleaved_write_frame() will wait until it has at least one packet
         * for each stream before actually writing any packets to the output file.
         * When some streams are "sparse" (i.e. there are large gaps between
         * successive packets), this can result in excessive buffering.
         *
         * This field specifies the maximum difference between the timestamps of the
         * first and the last packet in the muxing queue, above which libavformat
         * will output a packet regardless of whether it has queued a packet for all
         * the streams.
         *
         * Muxing only, set by the caller before avformat_write_header().
    這個估計是爲了保證緩衝區內全部的流都被打包到文件中
         */
        int64_t max_interleave_delta;

        /**
         * Allow non-standard and experimental extension
         * @see AVCodecContext.strict_std_compliance
         */
        int strict_std_compliance;

        /**
         * Transport stream id.
         * This will be moved into demuxer private options. Thus no API/ABI compatibility
         */
        int ts_id;

        /**
         * Audio preload in microseconds.
         * Note, not all formats support this and unpredictable things may happen if it is used when not supported.
         * - encoding: Set by user via AVOptions (NO direct access)
         * - decoding: unused
         */
        int audio_preload;

        /**
         * Max chunk time in microseconds.
         * Note, not all formats support this and unpredictable things may happen if it is used when not supported.
         * - encoding: Set by user via AVOptions (NO direct access)
         * - decoding: unused
         */
        int max_chunk_duration;

        /**
         * Max chunk size in bytes
         * Note, not all formats support this and unpredictable things may happen if it is used when not supported.
         * - encoding: Set by user via AVOptions (NO direct access)
         * - decoding: unused
         */
        int max_chunk_size;

        /**
         * forces the use of wallclock timestamps as pts/dts of packets
         * This has undefined results in the presence of B frames.
         * - encoding: unused
         * - decoding: Set by user via AVOptions (NO direct access)
         */
        int use_wallclock_as_timestamps;

        /**
         * Avoid negative timestamps during muxing.
         *  0 -> allow negative timestamps
         *  1 -> avoid negative timestamps
         * -1 -> choose automatically (default)
         * Note, this only works when interleave_packet_per_dts is in use.
         * - encoding: Set by user via AVOptions (NO direct access)
         * - decoding: unused
         */
        int avoid_negative_ts;

        /**
         * avio flags, used to force AVIO_FLAG_DIRECT.
         * - encoding: unused
         * - decoding: Set by user via AVOptions (NO direct access)
         */
        int avio_flags;

        /**
         * The duration field can be estimated through various ways, and this field can be used
         * to know how the duration was estimated.
         * - encoding: unused
         * - decoding: Read by user via AVOptions (NO direct access)
         */
        enum AVDurationEstimationMethod duration_estimation_method;

        /**
         * Skip initial bytes when opening stream
         * - encoding: unused
         * - decoding: Set by user via AVOptions (NO direct access)
         */
        int64_t skip_initial_bytes;

        /**
         * Correct single timestamp overflows
         * - encoding: unused
         * - decoding: Set by user via AVOptions (NO direct access)
         */
        unsigned int correct_ts_overflow;

        /**
         * Force seeking to any (also non key) frames.
         * - encoding: unused
         * - decoding: Set by user via AVOptions (NO direct access)
         */
        int seek2any;

        /**
         * Flush the I/O context after each packet.
         * - encoding: Set by user via AVOptions (NO direct access)
         * - decoding: unused
         */
        int flush_packets;

        /**
         * format probing score.
         * The maximal score is AVPROBE_SCORE_MAX, its set when the demuxer probes
         * the format.
         * - encoding: unused
         * - decoding: set by avformat, read by user via av_format_get_probe_score() (NO direct access)
         */
        int probe_score;

        /**
         * number of bytes to read maximally to identify format.
         * - encoding: unused
         * - decoding: set by user through AVOPtions (NO direct access)
         */
        int format_probesize;

        /*****************************************************************
         * All fields below this line are not part of the public API. They
         * may not be used outside of libavformat and can be changed and
         * removed at will.
         * New public fields should be added right above.
    下面的都是私有的API
         *****************************************************************
         */

        /**
         * This buffer is only needed when packets were already buffered but
         * not decoded, for example to get the codec parameters in MPEG
         * streams.
         */
        struct AVPacketList *packet_buffer;
        struct AVPacketList *packet_buffer_end;

        /* av_seek_frame() support */
        int64_t data_offset; /**< offset of the first packet */

        /**
         * Raw packets from the demuxer, prior to parsing and decoding.
         * This buffer is used for buffering packets until the codec can
         * be identified, as parsing cannot be done without knowing the
         * codec.
         */
        struct AVPacketList *raw_packet_buffer;
        struct AVPacketList *raw_packet_buffer_end;
        /**
         * Packets split by the parser get queued here.
         */
        struct AVPacketList *parse_queue;
        struct AVPacketList *parse_queue_end;
        /**
         * Remaining size available for raw_packet_buffer, in bytes.
         */
    #define RAW_PACKET_BUFFER_SIZE 2500000
        int raw_packet_buffer_remaining_size;

        /**
         * Offset to remap timestamps to be non-negative.
         * Expressed in timebase units.
         * @see AVStream.mux_ts_offset
         */
        int64_t offset;

        /**
         * Timebase for the timestamp offset.
         */
        AVRational offset_timebase;

        /**
         * An opaque field for libavformat internal usage.
         * Must not be accessed in any way by callers.
         */
        AVFormatInternal *internal;

        /**
         * IO repositioned flag.
         * This is set by avformat when the underlaying IO context read pointer
         * is repositioned, for example when doing byte based seeking.
         * Demuxers can use the flag to detect such changes.
         */
        int io_repositioned;

        /**
         * Forced video codec.
         * This allows forcing a specific decoder, even when there are multiple with
         * the same codec_id.
         * Demuxing: Set by user via av_format_set_video_codec (NO direct access).
         */
        AVCodec *video_codec;

        /**
         * Forced audio codec.
         * This allows forcing a specific decoder, even when there are multiple with
         * the same codec_id.
         * Demuxing: Set by user via av_format_set_audio_codec (NO direct access).
         */
        AVCodec *audio_codec;

        /**
         * Forced subtitle codec.
         * This allows forcing a specific decoder, even when there are multiple with
         * the same codec_id.
        * Demuxing: Set by user via av_format_set_subtitle_codec (NO direct access).
         */
        AVCodec *subtitle_codec;

        /**
         * Number of bytes to be written as padding in a metadata header.
         * Demuxing: Unused.
         * Muxing: Set by user via av_format_set_metadata_header_padding.
         */
        int metadata_header_padding;

        /**
         * User data.
         * This is a place for some private data of the user.
         * Mostly usable with control_message_cb or any future callbacks in device's context.
         */
        void *opaque;

        /**
         * Callback used by devices to communicate with application.
         */
        av_format_control_message control_message_cb;

        /**
        * Output timestamp offset, in microseconds.
         * Muxing: set by user via AVOptions (NO direct access)
         */
        int64_t output_ts_offset;

        /**
         * Maximum duration (in AV_TIME_BASE units) of the data read
         * from input in avformat_find_stream_info().
         * Demuxing only, set by the caller before avformat_find_stream_info()
         * via AVOptions (NO direct access).
         * Can be set to 0 to let avformat choose using a heuristic.
         */
        int64_t max_analyze_duration2;
} AVFormatContext;