Go最全ffmpeg编程入门学习笔记(一) -入门_avcodec_free_context，Golang开发中常见的一些问题面试专题-CSDN博客

本文链接：https://blog.csdn.net/2401_84904391/article/details/138938965

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

 * - 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().
 * - muxing: set by the user before avformat_write_header(). The caller must
 *           take care of closing / freeing the IO context.
 *
 * Do NOT set this field if AVFMT_NOFILE flag is set in
 * iformat/oformat.flags. In such a case, the (de)muxer will handle
 * I/O in some other way and this field will be 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.
 *
 * Set by avformat_new_stream(), must not be modified by any other code.
 */
 // 输入媒体的AVStream个数
unsigned int nb_streams;
/**
 * A list of all streams in the file. New streams are created with
 * 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().
 * - muxing: streams are created by the user before avformat_write_header().
 *
 * Freed by libavformat in avformat_free_context().
 */
// 输入媒体的AVStream数组
AVStream **streams;

#if FF_API_FORMAT_FILENAME
/**
* input or output filename
*
* - demuxing: set by avformat_open_input()
* - muxing: may be set by the caller before avformat_write_header()
*
* @deprecated Use url instead.
*/
attribute_deprecated
char filename[1024];
#endif

/**
 * input or output URL. Unlike the old filename field, this field has no
 * length restriction.
 *
 * - demuxing: set by avformat_open_input(), initialized to an empty
 *             string if url parameter was NULL in avformat_open_input().
 * - muxing: may be set by the caller before calling avformat_write_header()
 *           (or avformat_init_output() if that is called first) to a string
 *           which is freeable by av_free(). Set to an empty string if it
 *           was NULL in avformat_init_output().
 *
 * Freed by libavformat in avformat_free_context().
 */
char *url;

/**
 * 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.
 */
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.
 */
// 输入媒体的时长(以微妙为单位)，计算方式参考av_dump_format函数
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.
 */
// 输入媒体的码率
int64_t 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
#if FF_API_LAVF_MP4A_LATM
#define AVFMT_FLAG_MP4A_LATM 0x8000 ///< Deprecated, does nothing.
#endif
#define AVFMT_FLAG_SORT_DTS 0x10000 ///< try to interleave outputted packets by dts (using this flag can slow demuxing down)
#if FF_API_LAVF_PRIV_OPT
#define AVFMT_FLAG_PRIV_OPT 0x20000 ///< Enable use of private options by delaying codec open (deprecated, will do nothing once av_demuxer_open() is removed)
#endif
#if FF_API_LAVF_KEEPSIDE_FLAG
#define AVFMT_FLAG_KEEP_SIDE_DATA 0x40000 ///< Deprecated, does nothing.
#endif
#define AVFMT_FLAG_FAST_SEEK 0x80000 ///< Enable fast, but inaccurate seeks for some formats
#define AVFMT_FLAG_SHORTEST 0x100000 ///< Stop muxing when the shortest stream stops.
#define AVFMT_FLAG_AUTO_BSF 0x200000 ///< Add bitstream filters as requested by the muxer

/**
- Maximum size of the data read from input for determining
- the input container format.
- Demuxing only, set by the caller before avformat_open_input().
  */
  int64_t probesize;
/**
- 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().
- Can be set to 0 to let avformat choose using a heuristic.
  */
  int64_t 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.
```
*/
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.
*/
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;

/**
* Flags indicating events happening on the file, a combination of
* AVFMT_EVENT_FLAG_*.
*
* - demuxing: may be set by the demuxer in avformat_open_input(),
* avformat_find_stream_info() and av_read_frame(). Flags must be cleared
* by the user once the event has been handled.
* - muxing: may be set by the user after avformat_write_header() to
* indicate a user-triggered event. The muxer will clear the flags for
* events it has handled in av_[interleaved]_write_frame().
*/
int event_flags;
/**
* - demuxing: the demuxer read new metadata from the file and updated
* AVFormatContext.metadata accordingly
* - muxing: the user updated AVFormatContext.metadata and wishes the muxer to
* write it into the file
*/
#define AVFMT_EVENT_FLAG_METADATA_UPDATED 0x0001

/**
* Maximum number of packets to read while waiting for the first timestamp.
* Decoding only.
*/
int max_ts_probe;

/**
* Avoid negative timestamps during muxing.
* Any value of the AVFMT_AVOID_NEG_TS_* constants.
* Note, this only works when using av_interleaved_write_frame. (interleave_packet_per_dts is in use)
* - muxing: Set by user
* - demuxing: unused
*/
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

/**
* 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
* - 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
* - 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
* - 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
*/
int use_wallclock_as_timestamps;

/**
* avio flags, used to force AVIO_FLAG_DIRECT.
* - encoding: unused
* - decoding: Set by user
*/
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
*/
enum AVDurationEstimationMethod duration_estimation_method;

/**
* Skip initial bytes when opening stream
* - encoding: unused
* - decoding: Set by user
*/
int64_t skip_initial_bytes;

/**
* Correct single timestamp overflows
* - encoding: unused
* - decoding: Set by user
*/
unsigned int correct_ts_overflow;

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

/**
* Flush the I/O context after each packet.
* - encoding: Set by user
* - 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
*/
int probe_score;

/**
* number of bytes to read maximally to identify format.
* - encoding: unused
* - decoding: set by user
*/
int format_probesize;

/**
* ‘,’ separated list of allowed decoders.
* If NULL then all are allowed
* - encoding: unused
* - decoding: set by user
*/
char *codec_whitelist;

/**
* ‘,’ separated list of allowed demuxers.
* If NULL then all are allowed
* - encoding: unused
* - decoding: set by user
*/
char *format_whitelist;

/**
* 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
*/
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
*/
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
*/
AVCodec *subtitle_codec;

/**
* Forced data codec.
* This allows forcing a specific decoder, even when there are multiple with
* the same codec_id.
* Demuxing: Set by user
*/
AVCodec *data_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.
*/
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
*/
int64_t output_ts_offset;

/**
* dump format separator.
* can be ", " or "\n " or anything else
* - muxing: Set by user.
* - demuxing: Set by user.
*/
uint8_t *dump_separator;

/**
* Forced Data codec_id.
* Demuxing: Set by user.
*/
enum AVCodecID data_codec_id;

#if FF_API_OLD_OPEN_CALLBACKS
/**
* Called to open further IO contexts when needed for demuxing.
*
* This can be set by the user application to perform security checks on
* the URLs before opening them.
* The function should behave like avio_open2(), AVFormatContext is provided
* as contextual information and to reach AVFormatContext.opaque.
*
* If NULL then some simple checks are used together with avio_open2().
*
* Must not be accessed directly from outside avformat.
* @See av_format_set_open_cb()
*
* Demuxing: Set by user.
*
* @deprecated Use io_open and io_close.
*/
attribute_deprecated
int (*open_cb)(struct AVFormatContext *s, AVIOContext **p, const char *url, int flags, const AVIOInterruptCB *int_cb, AVDictionary **options);
#endif

/**
* ‘,’ separated list of allowed protocols.
* - encoding: unused
* - decoding: set by user
*/
char *protocol_whitelist;

/**
* A callback for opening new IO streams.
*
* Whenever a muxer or a demuxer needs to open an IO stream (typically from
* avformat_open_input() for demuxers, but for certain formats can happen at
* other times as well), it will call this callback to obtain an IO context.
*
* @param s the format context
* @param pb on success, the newly opened IO context should be returned here
* @param url the url to open
* @param flags a combination of AVIO_FLAG_*
* @param options a dictionary of additional options, with the same
* semantics as in avio_open2()
* @return 0 on success, a negative AVERROR code on failure
*
* @note Certain muxers and demuxers do nesting, i.e. they open one or more
* additional internal format contexts. Thus the AVFormatContext pointer
* passed to this callback may be different from the one facing the caller.
* It will, however, have the same ‘opaque’ field.
*/
int (*io_open)(struct AVFormatContext *s, AVIOContext **pb, const char *url,
int flags, AVDictionary **options);

/**
* A callback for closing the streams opened with AVFormatContext.io_open().
*/
void (*io_close)(struct AVFormatContext *s, AVIOContext *pb);

/**
* ‘,’ separated list of disallowed protocols.
* - encoding: unused
* - decoding: set by user
*/
char *protocol_blacklist;

/**
 * The maximum number of streams.
 * - encoding: unused
 * - decoding: set by user
 */
int max_streams;

/**
 * Skip duration calcuation in estimate_timings_from_pts.
 * - encoding: unused
 * - decoding: set by user
 */
int skip_estimate_duration_from_pts;

/**
 * Maximum number of packets that can be probed
 * - encoding: unused
 * - decoding: set by user
 */
int max_probe_packets;

} AVFormatContext;


### 3.2 AVInputFormat demuxer和AVoutputFormat muxer


每种封装格式(如FLV、MKV、MP4、AVI)都有对应的结构体。该结构体定义位于avformat.h，其详细结构如下

/**

@addtogroup lavf_decoding
@{
/
typedef struct AVInputFormat {
/*
- A comma separated list of short names for the format. New names
- may be appended with a minor bump.
  */
  // 封装格式名称
  const char *name;
/**
- Descriptive name for the format, meant to be more human-readable
- than name. You should use the NULL_IF_CONFIG_SMALL() macro
- to define it.
  */
  const char *long_name;
/**
- Can use flags: AVFMT_NOFILE, AVFMT_NEEDNUMBER, AVFMT_SHOW_IDS,
- AVFMT_NOTIMESTAMPS, AVFMT_GENERIC_INDEX, AVFMT_TS_DISCONT, AVFMT_NOBINSEARCH,
- AVFMT_NOGENSEARCH, AVFMT_NO_BYTE_SEEK, AVFMT_SEEK_TO_PTS.
  */
  int flags;
/**
- If extensions are defined, then no probe is done. You should
- usually not use extension format guessing because it is not
- reliable enough
  */
  // 封装格式扩展名
  const char *extensions;
const struct AVCodecTag * const *codec_tag;

const AVClass *priv_class; ///< AVClass for the private context

/**
- Comma-separated list of mime types.
- It is used check for matching mime types while probing.
- @see av_probe_input_format2
  */
  const char *mime_type;
/*****************************************************************
- No fields below this line are 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.
*/
#if FF_API_NEXT
ff_const59 struct AVInputFormat *next;
#endif

/**
- Raw demuxers store their codec ID here.
  */
  int raw_codec_id;
/**
- Size of private data so that it can be allocated in the wrapper.
  */
  int priv_data_size;
/**
- Tell if a given file has a chance of being parsed as this format.
- The buffer provided is guaranteed to be AVPROBE_PADDING_SIZE bytes
- big so you do not have to check for that unless you need more.
  */
  int (*read_probe)(const AVProbeData *);
/**
- Read the format header and initialize the AVFormatContext
- structure. Return 0 if OK. ‘avformat_new_stream’ should be
- called to create new streams.
  */
  int (*read_header)(struct AVFormatContext *);
/**
- Read one packet and put it in ‘pkt’. pts and flags are also
- set. ‘avformat_new_stream’ can be called only if the flag
- AVFMTCTX_NOHEADER is used and only in the calling thread (not in a
- background thread).
- @return 0 on success, < 0 on error.
- ```
    Upon returning an error, pkt must be unreferenced by the caller.
```
*/
int (*read_packet)(struct AVFormatContext *, AVPacket *pkt);

/**
- Close the stream. The AVFormatContext and AVStreams are not
- freed by this function
  */
  int (*read_close)(struct AVFormatContext *);
/**
- Seek to a given timestamp relative to the frames in
- stream component stream_index.
- @param stream_index Must not be -1.
- @param flags Selects which direction should be preferred if no exact
- ```
         match is available.
```
- @return >= 0 on success (but not necessarily the new offset)
  */
  int (*read_seek)(struct AVFormatContext *,
  int stream_index, int64_t timestamp, int flags);
/**
- Get the next timestamp in stream[stream_index].time_base units.
- @return the timestamp or AV_NOPTS_VALUE if an error occurred
  */
  int64_t (*read_timestamp)(struct AVFormatContext *s, int stream_index,
  int64_t *pos, int64_t pos_limit);
/**
- Start/resume playing - only meaningful if using a network-based format
- (RTSP).
  */
  int (*read_play)(struct AVFormatContext *);
/**
- Pause playing - only meaningful if using a network-based format
- (RTSP).
  */
  int (*read_pause)(struct AVFormatContext *);
/**
- Seek to timestamp ts.
- Seeking will be done so that the point from which all active streams
- can be presented successfully will be closest to ts and within min/max_ts.
- Active streams are all streams that have AVStream.discard < AVDISCARD_ALL.
  */
  int (*read_seek2)(struct AVFormatContext *s, int stream_index, int64_t min_ts, int64_t ts, int64_t max_ts, int flags);
/**
- Returns device list with it properties.
- @see avdevice_list_devices() for more details.
  */
  int (*get_device_list)(struct AVFormatContext *s, struct AVDeviceInfoList *device_list);

#if LIBAVFORMAT_VERSION_MAJOR < 59
/**
* Initialize device capabilities submodule.
* @see avdevice_capabilities_create() for more details.
*/
int (*create_device_capabilities)(struct AVFormatContext *s, struct AVDeviceCapabilitiesQuery *caps);

/**
 * Free device capabilities submodule.
 * @see avdevice_capabilities_free() for more details.
 */
int (*free_device_capabilities)(struct AVFormatContext *s, struct AVDeviceCapabilitiesQuery *caps);

#endif
} AVInputFormat;
/**





### 3.3 AVStream


视频文件中每个视频(音频)流对应一个结构体。该结构体定义位于avformat.h，其详细结构如下

/**

Stream structure.
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(AVStream) must not be used outside libav*.
*/
typedef struct AVStream {
// 标识该视频/音频流的序号
int index; /*< stream index in AVFormatContext /
/
- Format-specific stream ID.
- decoding: set by libavformat
- encoding: set by the user, replaced by libavformat if left unset
  /
  int id;
  #if FF_API_LAVF_AVCTX
  /*
- @deprecated use the codecpar struct instead
  */
  attribute_deprecated
  AVCodecContext *codec;
  #endif
  void *priv_data;
/**
- This is the fundamental unit of time (in seconds) in terms
- of which frame timestamps are represented.
- decoding: set by libavformat
- encoding: May be set by the caller before avformat_write_header() to
- ```
      provide a hint to the muxer about the desired timebase. In
```
- ```
      avformat_write_header(), the muxer will overwrite this field
```
- ```
      with the timebase that will actually be used for the timestamps
```
- ```
      written into the file (which may or may not be related to the
```
- ```
      user-provided one, depending on the format).
```
/
// 该流的时基，PTStime_base=真正的时间(秒)
AVRational time_base;

/**
- Decoding: pts of the first frame of the stream in presentation order, in stream time base.
- Only set this if you are absolutely 100% sure that the value you set
- it to really is the pts of the first frame.
- This may be undefined (AV_NOPTS_VALUE).
- @note The ASF header does NOT contain a correct start_time the ASF
- demuxer must NOT set this.
  */
  int64_t start_time;
/**
- Decoding: duration of the stream, in stream time base.
- If a source file does not specify a duration, but does specify
- a bitrate, this value will be estimated from bitrate and file size.
- Encoding: May be set by the caller before avformat_write_header() to
- provide a hint to the muxer about the estimated duration.
  */
  //该视频/音频流的长度
  int64_t duration;
int64_t nb_frames; ///< number of frames in this stream if known or 0

int disposition; /**< AV_DISPOSITION_* bit field */

enum AVDiscard discard; ///< Selects which packets can be discarded at will and do not need to be demuxed.

/**
- sample aspect ratio (0 if unknown)
- - encoding: Set by user.
- - decoding: Set by libavformat.
    */
    AVRational sample_aspect_ratio;
AVDictionary *metadata;

/**
- Average framerate
- - demuxing: May be set by libavformat when creating the stream or in
- ```
        avformat_find_stream_info().
```
- - muxing: May be set by the caller before avformat_write_header().
    */
    // 该流的帧率
    AVRational avg_frame_rate;
/**
- For streams with AV_DISPOSITION_ATTACHED_PIC disposition, this packet
- will contain the attached picture.
- decoding: set by libavformat, must not be modified by the caller.
- encoding: unused
  */
  AVPacket attached_pic;
/**
- An array of side data that applies to the whole stream (i.e. the
- container does not allow it to change between packets).
- There may be no overlap between the side data in this array and side data
- in the packets. I.e. a given side data is either exported by the muxer
- (demuxing) / set by the caller (muxing) in this array, then it never
- appears in the packets, or the side data is exported / sent through
- the packets (always in the first packet where the value becomes known or
- changes), then it does not appear in this array.
- - demuxing: Set by libavformat when the stream is created.
- - muxing: May be set by the caller before avformat_write_header().
- Freed by libavformat in avformat_free_context().
- @see av_format_inject_global_side_data()
  /
  AVPacketSideData side_data;
  /
- The number of elements in the AVStream.side_data array.
  */
  int nb_side_data;
/**
- Flags indicating events happening on the stream, a combination of
- AVSTREAM_EVENT_FLAG_*.
- - demuxing: may be set by the demuxer in avformat_open_input(),
- avformat_find_stream_info() and av_read_frame(). Flags must be cleared
- by the user once the event has been handled.
- - muxing: may be set by the user after avformat_write_header(). to
- indicate a user-triggered event. The muxer will clear the flags for
- events it has handled in av_[interleaved]_write_frame().
  /
  int event_flags;
  /*
- demuxing: the demuxer read new metadata from the file and updated
```
AVStream.metadata accordingly
```
- muxing: the user updated AVStream.metadata and wishes the muxer to write
```
it into the file
```

/
#define AVSTREAM_EVENT_FLAG_METADATA_UPDATED 0x0001
/*

- demuxing: new packets for this stream were read from the file. This
event is informational only and does not guarantee that new packets
for this stream will necessarily be returned from av_read_frame().
*/
#define AVSTREAM_EVENT_FLAG_NEW_PACKETS (1 << 1)

/**
 * Real base framerate of the stream.
 * This is the lowest framerate with which all timestamps can be
 * represented accurately (it is the least common multiple of all
 * framerates in the stream). Note, this value is just a guess!
 * For example, if the time base is 1/90000 and all frames have either
 * approximately 3600 or 1800 timer ticks, then r_frame_rate will be 50/1.
 */
AVRational r_frame_rate;

#if FF_API_LAVF_FFSERVER
/**
* String containing pairs of key and values describing recommended encoder configuration.
* Pairs are separated by ‘,’.
* Keys are separated from values by ‘=’.
*
* @deprecated unused
*/
attribute_deprecated
char *recommended_encoder_configuration;
#endif

/**
 * Codec parameters associated with this stream. Allocated and freed by
 * libavformat in avformat_new_stream() and avformat_free_context()
 * respectively.
 *
 * - demuxing: filled by libavformat on stream creation or in
 *             avformat_find_stream_info()
 * - muxing: filled by the caller before avformat_write_header()
 */
// 该解码器参数属性
AVCodecParameters *codecpar;

/*****************************************************************
 * 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.
 * Internal note: be aware that physically removing these fields
 * will break ABI. Replace removed fields with dummy fields, and
 * add new fields to AVStreamInternal.
 *****************************************************************
 */

#if LIBAVFORMAT_VERSION_MAJOR < 59
// kept for ABI compatibility only, do not access in any way
void *unused;
#endif

int pts_wrap_bits; /**< number of bits in pts (used for wrapping control) */

// Timestamp generation support:
/**
 * Timestamp corresponding to the last dts sync point.
 *
 * Initialized when AVCodecParserContext.dts_sync_point >= 0 and
 * a DTS is received from the underlying container. Otherwise set to
 * AV_NOPTS_VALUE by default.
 */
int64_t first_dts;
int64_t cur_dts;
int64_t last_IP_pts;
int last_IP_duration;

/**
 * Number of packets to buffer for codec probing
 */
int probe_packets;

/**
 * Number of frames that have been demuxed during avformat_find_stream_info()
 */
int codec_info_nb_frames;

/* av_read_frame() support */
enum AVStreamParseType need_parsing;
struct AVCodecParserContext *parser;

#if LIBAVFORMAT_VERSION_MAJOR < 59
// kept for ABI compatibility only, do not access in any way
void *unused7;
AVProbeData unused6;
int64_t unused5[16+1];
#endif
AVIndexEntry *index_entries; /**< Only used if the format does not
support seeking natively. */
int nb_index_entries;
unsigned int index_entries_allocated_size;

/**
 * Stream Identifier
 * This is the MPEG-TS stream identifier +1
 * 0 means unknown
 */
int stream_identifier;

#if LIBAVFORMAT_VERSION_MAJOR < 59
// kept for ABI compatibility only, do not access in any way
int unused8;
int unused9;
int unused10;
#endif

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

} AVStream;


### 3.4 AVCodecContext


编解码器上下文结构体，保存了视频(音频)编解码相关信息。该结构体定义位于avcodec.h，其详细结构如下

/**

main external API structure.
New fields can be added to the end with minor version bumps.
Removal, reordering and changes to existing fields require a major
version bump.
You can use AVOptions (av_opt* / av_set/get*()) to access these fields from user
applications.
The name string for AVOptions options matches the associated command line
parameter name and can be found in libavcodec/options_table.h
The AVOption/command line parameter names differ in some cases from the C
structure field names for historic reasons or brevity.
sizeof(AVCodecContext) must not be used outside libav*.
/
typedef struct AVCodecContext {
/*
- information on struct for av_log
- - set by avcodec_alloc_context3
    */
    const AVClass *av_class;
    int log_level_offset;
enum AVMediaType codec_type; /* see AVMEDIA_TYPE_xxx */
// 编解码器的AVCodec，比如指向AVCodecff_aac_latm_decoder
const struct AVCodec codec;
enum AVCodecID codec_id; / see AV_CODEC_ID_xxx */

/**
- fourcc (LSB first, so “ABCD” -> (‘D’<<24) + (‘C’<<16) + (‘B’<<8) + ‘A’).
- This is used to work around some encoder bugs.
- A demuxer should set this to what is stored in the field used to identify the codec.
- If there are multiple such fields in a container then the demuxer should choose the one
- which maximizes the information about the used codec.
- If the codec tag field in a container is larger than 32 bits then the demuxer should
- remap the longer ID to 32 bits with a table or other structure. Alternatively a new
- extra_codec_tag + size could be added but for this a clear advantage must be demonstrated
- first.
- - encoding: Set by user, if not then the default based on codec_id will be used.
- - decoding: Set by user, will be converted to uppercase by libavcodec during init.
    */
    unsigned int codec_tag;
void *priv_data;

/**
- Private context used for internal data.
- Unlike priv_data, this is not codec-specific. It is used in general
- libavcodec functions.
  */
  struct AVCodecInternal *internal;
/**
- Private data of the user, can be used to carry app specific stuff.
- - encoding: Set by user.
- - decoding: Set by user.
    */
    void *opaque;
/**
- the average bitrate
- - encoding: Set by user; unused for constant quantizer encoding.
- - decoding: Set by user, may be overwritten by libavcodec
- ```
        if this info is available in the stream
```
*/
int64_t bit_rate;

/**
- number of bits the bitstream is allowed to diverge from the reference.
- ```
      the reference can be CBR (for CBR pass1) or VBR (for pass2)
```
- - encoding: Set by user; unused for constant quantizer encoding.
- - decoding: unused
    */
    int bit_rate_tolerance;
/**
- Global quality for codecs which cannot change it per frame.
- This should be proportional to MPEG-1/2/4 qscale.
- - encoding: Set by user.
- - decoding: unused
    */
    int global_quality;
/**
- - encoding: Set by user.
- - decoding: unused
    */
    int compression_level;
    #define FF_COMPRESSION_DEFAULT -1
/**
- AV_CODEC_FLAG_*.
- - encoding: Set by user.
- - decoding: Set by user.
    */
    int flags;
/**
- AV_CODEC_FLAG2_*
- - encoding: Set by user.
- - decoding: Set by user.
    */
    int flags2;
/**
- some codecs need / can use extradata like Huffman tables.
- MJPEG: Huffman tables
- rv10: additional flags
- MPEG-4: global headers (they can be in the bitstream or here)
- The allocated memory should be AV_INPUT_BUFFER_PADDING_SIZE bytes larger
- than extradata_size to avoid problems if it is read with the bitstream reader.
- The bytewise contents of extradata must not depend on the architecture or CPU endianness.
- Must be allocated with the av_malloc() family of functions.
- - encoding: Set/allocated/freed by libavcodec.
- - decoding: Set/allocated/freed by user.
    */
    uint8_t *extradata;
    int extradata_size;
/**
- This is the fundamental unit of time (in seconds) in terms
- of which frame timestamps are represented. For fixed-fps content,
- timebase should be 1/framerate and timestamp increments should be
- identically 1.
- This often, but not always is the inverse of the frame rate or field rate
- for video. 1/time_base is not the average frame rate if the frame rate is not
- constant.
- Like containers, elementary streams also can store timestamps, 1/time_base
- is the unit in which these timestamps are specified.
- As example of such codec time base see ISO/IEC 14496-2:2001(E)
- vop_time_increment_resolution and fixed_vop_rate
- (fixed_vop_rate == 0 implies that it is different from the framerate)
- - encoding: MUST be set by user.
- - decoding: the use of this field for decoding is deprecated.
- ```
        Use framerate instead.
```
*/
AVRational time_base;

/**
- For some codecs, the time base is closer to the field rate than the frame rate.
- Most notably, H.264 and MPEG-2 specify time_base as half of frame duration
- if no telecine is used …
- Set to time_base ticks per frame. Default 1, e.g., H.264/MPEG-2 set it to 2.
  */
  int ticks_per_frame;
/**
- Codec delay.
- Encoding: Number of frames delay there will be from the encoder input to
- ```
      the decoder output. (we assume the decoder matches the spec)
```
- Decoding: Number of frames delay in addition to what a standard decoder
- ```
      as specified in the spec would produce.
```
- Video:
- Number of frames the decoded output will be delayed relative to the
- encoded input.
- Audio:
- For encoding, this field is unused (see initial_padding).
- For decoding, this is the number of samples the decoder needs to
- output before the decoder’s output is valid. When seeking, you should
  * start decoding this many samples prior to your desired seek point.
  *
  * - encoding: Set by libavcodec.
  * - decoding: Set by libavcodec.
  */
  int delay;

/* video only */
/**
* picture width / height.
*
* @note Those fields may not match the values of the last
* AVFrame output by avcodec_decode_video2 due frame
* reordering.
*
* - encoding: MUST be set by user.
* - decoding: May be set by the user before opening the decoder if known e.g.
* from the container. Some decoders will require the dimensions
* to be set by the caller. During decoding, the decoder may
* overwrite those values as required while parsing the data.
*/
// 图像的宽高，只针对视频
int width, height;

/**
* Bitstream width / height, may be different from width/height e.g. when
* the decoded frame is cropped before being output or lowres is enabled.
*
* @note Those field may not match the value of the last
* AVFrame output by avcodec_receive_frame() due frame
* reordering.
*
* - encoding: unused
* - decoding: May be set by the user before opening the decoder if known
* e.g. from the container. During decoding, the decoder may
* overwrite those values as required while parsing the data.
*/
int coded_width, coded_height;

/**
* the number of pictures in a group of pictures, or 0 for intra_only
* - encoding: Set by user.
* - decoding: unused
*/
int gop_size;

/**
* Pixel format, see AV_PIX_FMT_xxx.
* May be set by the demuxer if known from headers.
* May be overridden by the decoder if it knows better.
*
* @note This field may not match the value of the last
* AVFrame output by avcodec_receive_frame() due frame
* reordering.
*
* - encoding: Set by user.
* - decoding: Set by user if known, overridden by libavcodec while
* parsing the data.
*/
//像素格式(只针对视频)
enum AVPixelFormat pix_fmt;

/**
* If non NULL, ‘draw_horiz_band’ is called by the libavcodec
* decoder to draw a horizontal band. It improves cache usage. Not
* all codecs can do that. You must check the codec capabilities
* beforehand.
* When multithreading is used, it may be called from multiple threads
* at the same time; threads might draw different parts of the same AVFrame,
* or multiple AVFrames, and there is no guarantee that slices will be drawn
* in order.
* The function is also used by hardware acceleration APIs.
* It is called at least once during frame decoding to pass
* the data needed for hardware render.
* In that mode instead of pixel data, AVFrame points to
* a structure specific to the acceleration API. The application
* reads the structure and can change some fields to indicate progress
* or mark state.
* - encoding: unused
* - decoding: Set by user.
* @param height the height of the slice
* @param y the y position of the slice
* @param type 1->top field, 2->bottom field, 3->frame
* @param offset offset into the AVFrame.data from which the slice should be read
*/
void (*draw_horiz_band)(struct AVCodecContext *s,
const AVFrame *src, int offset[AV_NUM_DATA_POINTERS],
int y, int type, int height);

/**
* callback to negotiate the pixelFormat
* @param fmt is the list of formats which are supported by the codec,
* it is terminated by -1 as 0 is a valid format, the formats are ordered by quality.
* The first is always the native one.
* @note The callback may be called again immediately if initialization for
* the selected (hardware-accelerated) pixel format failed.
* @warning Behavior is undefined if the callback returns a value not
* in the fmt list of formats.
* @return the chosen format
* - encoding: unused
* - decoding: Set by user, if not set the native format will be chosen.
*/
enum AVPixelFormat (*get_format)(struct AVCodecContext *s, const enum AVPixelFormat * fmt);

/**
* maximum number of B-frames between non-B-frames
* Note: The output will be delayed by max_b_frames+1 relative to the input.
* - encoding: Set by user.
* - decoding: unused
*/
int max_b_frames;

/**
* qscale factor between IP and B-frames
* If > 0 then the last P-frame quantizer will be used (q= lastp_q*factor+offset).
* If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
* - encoding: Set by user.
* - decoding: unused
*/
float b_quant_factor;

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int b_frame_strategy;
#endif

/**
* qscale offset between IP and B-frames
* - encoding: Set by user.
* - decoding: unused
*/
float b_quant_offset;

/**
* Size of the frame reordering buffer in the decoder.
* For MPEG-2 it is 1 IPB or 0 low delay IP.
* - encoding: Set by libavcodec.
* - decoding: Set by libavcodec.
*/
int has_b_frames;

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int mpeg_quant;
#endif

/**
* qscale factor between P- and I-frames
* If > 0 then the last P-frame quantizer will be used (q = lastp_q * factor + offset).
* If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
* - encoding: Set by user.
* - decoding: unused
*/
float i_quant_factor;

/**
* qscale offset between P and I-frames
* - encoding: Set by user.
* - decoding: unused
*/
float i_quant_offset;

/**
* luminance masking (0-> disabled)
* - encoding: Set by user.
* - decoding: unused
*/
float lumi_masking;

/**
* temporary complexity masking (0-> disabled)
* - encoding: Set by user.
* - decoding: unused
*/
float temporal_cplx_masking;

/**
* spatial complexity masking (0-> disabled)
* - encoding: Set by user.
* - decoding: unused
*/
float spatial_cplx_masking;

/**
* p block masking (0-> disabled)
* - encoding: Set by user.
* - decoding: unused
*/
float p_masking;

/**
* darkness masking (0-> disabled)
* - encoding: Set by user.
* - decoding: unused
*/
float dark_masking;

/**
* slice count
* - encoding: Set by libavcodec.
* - decoding: Set by user (or 0).
*/
int slice_count;

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int prediction_method;
#define FF_PRED_LEFT 0
#define FF_PRED_PLANE 1
#define FF_PRED_MEDIAN 2
#endif

/**
* slice offsets in the frame in bytes
* - encoding: Set/allocated by libavcodec.
* - decoding: Set/allocated by user (or NULL).
*/
int *slice_offset;

/**
* sample aspect ratio (0 if unknown)
* That is the width of a pixel divided by the height of the pixel.
* Numerator and denominator must be relatively prime and smaller than 256 for some video standards.
* - encoding: Set by user.
* - decoding: Set by libavcodec.
*/
AVRational sample_aspect_ratio;

/**
* motion estimation comparison function
* - encoding: Set by user.
* - decoding: unused
*/
int me_cmp;
/**
* subpixel motion estimation comparison function
* - encoding: Set by user.
* - decoding: unused
*/
int me_sub_cmp;
/**
* macroblock comparison function (not supported yet)
* - encoding: Set by user.
* - decoding: unused
*/
int mb_cmp;
/**
* interlaced DCT comparison function
* - encoding: Set by user.
* - decoding: unused
*/
int ildct_cmp;
#define FF_CMP_SAD 0
#define FF_CMP_SSE 1
#define FF_CMP_SATD 2
#define FF_CMP_DCT 3
#define FF_CMP_PSNR 4
#define FF_CMP_BIT 5
#define FF_CMP_RD 6
#define FF_CMP_ZERO 7
#define FF_CMP_VSAD 8
#define FF_CMP_VSSE 9
#define FF_CMP_NSSE 10
#define FF_CMP_W53 11
#define FF_CMP_W97 12
#define FF_CMP_DCTMAX 13
#define FF_CMP_DCT264 14
#define FF_CMP_MEDIAN_SAD 15
#define FF_CMP_CHROMA 256

/**
* ME diamond size & shape
* - encoding: Set by user.
* - decoding: unused
*/
int dia_size;

/**
* amount of previous MV predictors (2a+1 x 2a+1 square)
* - encoding: Set by user.
* - decoding: unused
*/
int last_predictor_count;

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int pre_me;
#endif

/**
* motion estimation prepass comparison function
* - encoding: Set by user.
* - decoding: unused
*/
int me_pre_cmp;

/**
* ME prepass diamond size & shape
* - encoding: Set by user.
* - decoding: unused
*/
int pre_dia_size;

/**
* subpel ME quality
* - encoding: Set by user.
* - decoding: unused
*/
int me_subpel_quality;

/**
* maximum motion estimation search range in subpel units
* If 0 then no limit.
*
* - encoding: Set by user.
* - decoding: unused
*/
int me_range;

/**
* slice flags
* - encoding: unused
* - decoding: Set by user.
*/
int slice_flags;
#define SLICE_FLAG_CODED_ORDER 0x0001 ///< draw_horiz_band() is called in coded order instead of display
#define SLICE_FLAG_ALLOW_FIELD 0x0002 ///< allow draw_horiz_band() with field slices (MPEG-2 field pics)
#define SLICE_FLAG_ALLOW_PLANE 0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)

/**
* macroblock decision mode
* - encoding: Set by user.
* - decoding: unused
*/
int mb_decision;
#define FF_MB_DECISION_SIMPLE 0 ///< uses mb_cmp
#define FF_MB_DECISION_BITS 1 ///< chooses the one which needs the fewest bits
#define FF_MB_DECISION_RD 2 ///< rate distortion

/**
* custom intra quantization matrix
* Must be allocated with the av_malloc() family of functions, and will be freed in
* avcodec_free_context().
* - encoding: Set/allocated by user, freed by libavcodec. Can be NULL.
* - decoding: Set/allocated/freed by libavcodec.
*/
uint16_t *intra_matrix;

/**
* custom inter quantization matrix
* Must be allocated with the av_malloc() family of functions, and will be freed in
* avcodec_free_context().
* - encoding: Set/allocated by user, freed by libavcodec. Can be NULL.
* - decoding: Set/allocated/freed by libavcodec.
*/
uint16_t *inter_matrix;

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int scenechange_threshold;

/** @deprecated use encoder private options instead */
attribute_deprecated
int noise_reduction;
#endif

/**
* precision of the intra DC coefficient - 8
* - encoding: Set by user.
* - decoding: Set by libavcodec
*/
int intra_dc_precision;

/**
* Number of macroblock rows at the top which are skipped.
* - encoding: unused
* - decoding: Set by user.
*/
int skip_top;

/**
* Number of macroblock rows at the bottom which are skipped.
* - encoding: unused
* - decoding: Set by user.
*/
int skip_bottom;

/**
* minimum MB Lagrange multiplier
* - encoding: Set by user.
* - decoding: unused
*/
int mb_lmin;

/**
* maximum MB Lagrange multiplier
* - encoding: Set by user.
* - decoding: unused
*/
int mb_lmax;

#if FF_API_PRIVATE_OPT
/**
* @deprecated use encoder private options instead
*/
attribute_deprecated
int me_penalty_compensation;
#endif

/**
* - encoding: Set by user.
* - decoding: unused
*/
int bidir_refine;

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int brd_scale;
#endif

/**
* minimum GOP size
* - encoding: Set by user.
* - decoding: unused
*/
int keyint_min;

/**
* number of reference frames
* - encoding: Set by user.
* - decoding: Set by lavc.
*/
int refs;

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int chromaoffset;
#endif

/**
* Note: Value depends upon the compare function used for fullpel ME.
* - encoding: Set by user.
* - decoding: unused
*/
int mv0_threshold;

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int b_sensitivity;
#endif

/**
* Chromaticity coordinates of the source primaries.
* - encoding: Set by user
* - decoding: Set by libavcodec
*/
enum AVColorPrimaries color_primaries;

/**
* Color Transfer Characteristic.
* - encoding: Set by user
* - decoding: Set by libavcodec
*/
enum AVColorTransferCharacteristic color_trc;

/**
* YUV colorspace type.
* - encoding: Set by user
* - decoding: Set by libavcodec
*/
enum AVColorSpace colorspace;

/**
* MPEG vs JPEG YUV range.
* - encoding: Set by user
* - decoding: Set by libavcodec
*/
enum AVColorRange color_range;

/**
* This defines the location of chroma samples.
* - encoding: Set by user
* - decoding: Set by libavcodec
*/
enum AVChromaLocation chroma_sample_location;

/**
* Number of slices.
* Indicates number of picture subdivisions. Used for parallelized
* decoding.
* - encoding: Set by user
* - decoding: unused
*/
int slices;

/** Field order
* - encoding: set by libavcodec
* - decoding: Set by user.
*/
enum AVFieldOrder field_order;

/* audio only */
int sample_rate; // 采样率(秒)
int channels; // 声道数

/**
* audio sample format
* - encoding: Set by user.
* - decoding: Set by libavcodec.
*/
enum AVSampleFormat sample_fmt; //采样格式

/* The following data should not be initialized. */
/**
* Number of samples per channel in an audio frame.
*
* - encoding: set by libavcodec in avcodec_open2(). Each submitted frame
* except the last must contain exactly frame_size samples per channel.
* May be 0 when the codec has AV_CODEC_CAP_VARIABLE_FRAME_SIZE set, then the
* frame size is not restricted.
* - decoding: may be set by some decoders to indicate constant frame size
*/
int frame_size;

/**
* Frame counter, set by libavcodec.
*
* - decoding: total number of frames returned from the decoder so far.
* - encoding: total number of frames passed to the encoder so far.
*
* @note the counter is not incremented if encoding/decoding resulted in
* an error.
*/
int frame_number;

/**
* number of bytes per packet if constant and known or 0
* Used by some WAV based audio codecs.
*/
int block_align;

/**
* Audio cutoff bandwidth (0 means “automatic”)
* - encoding: Set by user.
* - decoding: unused
*/
int cutoff;

/**
* Audio channel layout.
* - encoding: set by user.
* - decoding: set by user, may be overwritten by libavcodec.
*/
uint64_t channel_layout;

/**
* Request decoder to use this channel layout if it can (0 for default)
* - encoding: unused
* - decoding: Set by user.
*/
uint64_t request_channel_layout;

/**
* Type of service that the audio stream conveys.
* - encoding: Set by user.
* - decoding: Set by libavcodec.
*/
enum AVAudioServiceType audio_service_type;

/**
* desired sample format
* - encoding: Not used.
* - decoding: Set by user.
* Decoder will decode to this format if it can.
*/
enum AVSampleFormat request_sample_fmt;

/**
* This callback is called at the beginning of each frame to get data
* buffer(s) for it. There may be one contiguous buffer for all the data or
* there may be a buffer per each data plane or anything in between. What
* this means is, you may set however many entries in buf[] you feel necessary.
* Each buffer must be reference-counted using the AVBuffer API (see description
* of buf[] below).
*
* The following fields will be set in the frame before this callback is
* called:
* - format
* - width, height (video only)
* - sample_rate, channel_layout, nb_samples (audio only)
* Their values may differ from the corresponding values in
* AVCodecContext. This callback must use the frame values, not the codec
* context values, to calculate the required buffer size.
*
* This callback must fill the following fields in the frame:
* - data[]
* - linesize[]
* - extended_data:
* * if the data is planar audio with more than 8 channels, then this
* callback must allocate and fill extended_data to contain all pointers
* to all data planes. data[] must hold as many pointers as it can.
* extended_data must be allocated with av_malloc() and will be freed in
* av_frame_unref().
* * otherwise extended_data must point to data
* - buf[] must contain one or more pointers to AVBufferRef structures. Each of
* the frame’s data and extended_data pointers must be contained in these. That
* is, one AVBufferRef for each allocated chunk of memory, not necessarily one
* AVBufferRef per data[] entry. See: av_buffer_create(), av_buffer_alloc(),
* and av_buffer_ref().
* - extended_buf and nb_extended_buf must be allocated with av_malloc() by
* this callback and filled with the extra buffers if there are more
* buffers than buf[] can hold. extended_buf will be freed in
* av_frame_unref().
*
* If AV_CODEC_CAP_DR1 is not set then get_buffer2() must call
* avcodec_default_get_buffer2() instead of providing buffers allocated by
* some other means.
*
* Each data plane must be aligned to the maximum required by the target
* CPU.
*
* @see avcodec_default_get_buffer2()
*
* Video:
*
* If AV_GET_BUFFER_FLAG_REF is set in flags then the frame may be reused
* (read and/or written to if it is writable) later by libavcodec.
*
* avcodec_align_dimensions2() should be used to find the required width and
* height, as they normally need to be rounded up to the next multiple of 16.
*
* Some decoders do not support linesizes changing between frames.
*
* If frame multithreading is used, this callback may be called from a
* different thread, but not from more than one at once. Does not need to be
* reentrant.
*
* @see avcodec_align_dimensions2()
*
* Audio:
*
* Decoders request a buffer of a particular size by setting
* AVFrame.nb_samples prior to calling get_buffer2(). The decoder may,
* however, utilize only part of the buffer by setting AVFrame.nb_samples
* to a smaller value in the output frame.
*
* As a convenience, av_samples_get_buffer_size() and
* av_samples_fill_arrays() in libavutil may be used by custom get_buffer2()
* functions to find the required data size and to fill data pointers and
* linesize. In AVFrame.linesize, only linesize[0] may be set for audio
* since all planes must be the same size.
*
* @see av_samples_get_buffer_size(), av_samples_fill_arrays()
*
* - encoding: unused
* - decoding: Set by libavcodec, user can override.
*/
int (*get_buffer2)(struct AVCodecContext *s, AVFrame *frame, int flags);

#if FF_API_OLD_ENCDEC
/**
* If non-zero, the decoded audio and video frames returned from
* avcodec_decode_video2() and avcodec_decode_audio4() are reference-counted
* and are valid indefinitely. The caller must free them with
* av_frame_unref() when they are not needed anymore.
* Otherwise, the decoded frames must not be freed by the caller and are
* only valid until the next decode call.
*
* This is always automatically enabled if avcodec_receive_frame() is used.
*
* - encoding: unused
* - decoding: set by the caller before avcodec_open2().
*/
attribute_deprecated
int refcounted_frames;
#endif

/* - encoding parameters */
float qcompress;  ///< amount of qscale change between easy & hard scenes (0.0-1.0)
float qblur;      ///< amount of qscale smoothing over time (0.0-1.0)

/**
 * minimum quantizer
 * - encoding: Set by user.
 * - decoding: unused
 */
int qmin;

/**
 * maximum quantizer
 * - encoding: Set by user.
 * - decoding: unused
 */
int qmax;

/**
 * maximum quantizer difference between frames
 * - encoding: Set by user.
 * - decoding: unused
 */
int max_qdiff;

/**
 * decoder bitstream buffer size
 * - encoding: Set by user.
 * - decoding: unused
 */
int rc_buffer_size;

/**
 * ratecontrol override, see RcOverride
 * - encoding: Allocated/set/freed by user.
 * - decoding: unused
 */
int rc_override_count;
RcOverride *rc_override;

/**
 * maximum bitrate
 * - encoding: Set by user.
 * - decoding: Set by user, may be overwritten by libavcodec.
 */
int64_t rc_max_rate;

/**
 * minimum bitrate
 * - encoding: Set by user.
 * - decoding: unused
 */
int64_t rc_min_rate;

/**
 * Ratecontrol attempt to use, at maximum, <value> of what can be used without an underflow.
 * - encoding: Set by user.
 * - decoding: unused.
 */
float rc_max_available_vbv_use;

/**
 * Ratecontrol attempt to use, at least, <value> times the amount needed to prevent a vbv overflow.
 * - encoding: Set by user.
 * - decoding: unused.
 */
float rc_min_vbv_overflow_use;

/**
 * Number of bits which should be loaded into the rc buffer before decoding starts.
 * - encoding: Set by user.
 * - decoding: unused
 */
int rc_initial_buffer_occupancy;

#if FF_API_CODER_TYPE
#define FF_CODER_TYPE_VLC 0
#define FF_CODER_TYPE_AC 1
#define FF_CODER_TYPE_RAW 2
#define FF_CODER_TYPE_RLE 3
/**
* @deprecated use encoder private options instead
*/
attribute_deprecated
int coder_type;
#endif /* FF_API_CODER_TYPE */

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int context_model;
#endif

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int frame_skip_threshold;

/** @deprecated use encoder private options instead */
attribute_deprecated
int frame_skip_factor;

/** @deprecated use encoder private options instead */
attribute_deprecated
int frame_skip_exp;

/** @deprecated use encoder private options instead */
attribute_deprecated
int frame_skip_cmp;

#endif /* FF_API_PRIVATE_OPT */

/**
 * trellis RD quantization
 * - encoding: Set by user.
 * - decoding: unused
 */
int trellis;

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead */
attribute_deprecated
int min_prediction_order;

/** @deprecated use encoder private options instead */
attribute_deprecated
int max_prediction_order;

/** @deprecated use encoder private options instead */
attribute_deprecated
int64_t timecode_frame_start;

#endif

#if FF_API_RTP_CALLBACK
/**
* @deprecated unused
/
/ The RTP callback: This function is called /
/ every time the encoder has a packet to send. /
/ It depends on the encoder if the data starts /
/ with a Start Code (it should). H.263 does. /
/ mb_nb contains the number of macroblocks /
/ encoded in the RTP payload. */
attribute_deprecated
void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb);
#endif

#if FF_API_PRIVATE_OPT
/** @deprecated use encoder private options instead /
attribute_deprecated
int rtp_payload_size; / The size of the RTP payload: the coder will /
/ do its best to deliver a chunk with size /
/ below rtp_payload_size, the chunk will start /
/ with a start code on some codecs like H.263. /
/ This doesn’t take account of any particular */
/* headers inside the transmitted RTP payload. */
#endif

#if FF_API_STAT_BITS
/* statistics, used for 2-pass encoding */
attribute_deprecated
int mv_bits;
attribute_deprecated
int header_bits;
attribute_deprecated
int i_tex_bits;
attribute_deprecated
int p_tex_bits;
attribute_deprecated
int i_count;
attribute_deprecated
int p_count;
attribute_deprecated
int skip_count;
attribute_deprecated
int misc_bits;

/** @deprecated this field is unused */
attribute_deprecated
int frame_bits;
#endif

/**
* pass1 encoding statistics output buffer
* - encoding: Set by libavcodec.
* - decoding: unused
*/
char *stats_out;

/**
* pass2 encoding statistics input buffer
* Concatenated stuff from stats_out of pass1 should be placed here.
* - encoding: Allocated/set/freed by user.
* - decoding: unused
*/
char *stats_in;

/**
* Work around bugs in encoders which sometimes cannot be detected automatically.
* - encoding: Set by user
* - decoding: Set by user
*/
int workaround_bugs;
#define FF_BUG_AUTODETECT 1 ///< autodetection
#define FF_BUG_XVID_ILACE 4
#define FF_BUG_UMP4 8
#define FF_BUG_NO_PADDING 16
#define FF_BUG_AMV 32
#define FF_BUG_QPEL_CHROMA 64
#define FF_BUG_STD_QPEL 128
#define FF_BUG_QPEL_CHROMA2 256
#define FF_BUG_DIRECT_BLOCKSIZE 512
#define FF_BUG_EDGE 1024
#define FF_BUG_HPEL_CHROMA 2048
#define FF_BUG_DC_CLIP 4096
#define FF_BUG_MS 8192 ///< Work around various bugs in Microsoft’s broken decoders.
#define FF_BUG_TRUNCATED 16384
#define FF_BUG_IEDGE 32768

/**
 * strictly follow the standard (MPEG-4, ...).
 * - encoding: Set by user.
 * - decoding: Set by user.
 * Setting this to STRICT or higher means the encoder and decoder will
 * generally do stupid things, whereas setting it to unofficial or lower
 * will mean the encoder might produce output that is not supported by all
 * spec-compliant decoders. Decoders don't differentiate between normal,

* unofficial and experimental (that is, they always try to decode things
* when they can) unless they are explicitly asked to behave stupidly
* (=strictly conform to the specs)
*/
int strict_std_compliance;
#define FF_COMPLIANCE_VERY_STRICT 2 ///< Strictly conform to an older more strict version of the spec or reference software.
#define FF_COMPLIANCE_STRICT 1 ///< Strictly conform to all the things in the spec no matter what consequences.
#define FF_COMPLIANCE_NORMAL 0
#define FF_COMPLIANCE_UNOFFICIAL -1 ///< Allow unofficial extensions
#define FF_COMPLIANCE_EXPERIMENTAL -2 ///< Allow nonstandardized experimental things.

/**
* error concealment flags
* - encoding: unused
* - decoding: Set by user.
*/
int error_concealment;
#define FF_EC_GUESS_MVS 1
#define FF_EC_DEBLOCK 2
#define FF_EC_FAVOR_INTER 256

/**
* debug
* - encoding: Set by user.
* - decoding: Set by user.
*/
int debug;
#define FF_DEBUG_PICT_INFO 1
#define FF_DEBUG_RC 2
#define FF_DEBUG_BITSTREAM 4
#define FF_DEBUG_MB_TYPE 8
#define FF_DEBUG_QP 16
#define FF_DEBUG_DCT_COEFF 0x00000040
#define FF_DEBUG_SKIP 0x00000080
#define FF_DEBUG_STARTCODE 0x00000100
#define FF_DEBUG_ER 0x00000400
#define FF_DEBUG_MMCO 0x00000800
#define FF_DEBUG_BUGS 0x00001000
#define FF_DEBUG_BUFFERS 0x00008000
#define FF_DEBUG_THREADS 0x00010000
#define FF_DEBUG_GREEN_MD 0x00800000
#define FF_DEBUG_NOMC 0x01000000

/**
* Error recognition; may misdetect some more or less valid parts as errors.
* - encoding: Set by user.
* - decoding: Set by user.
*/
int err_recognition;

/**
* Verify checksums embedded in the bitstream (could be of either encoded or
* decoded data, depending on the codec) and print an error message on mismatch.
* If AV_EF_EXPLODE is also set, a mismatching checksum will result in the
* decoder returning an error.
*/
#define AV_EF_CRCCHECK (1<<0)
#define AV_EF_BITSTREAM (1<<1) ///< detect bitstream specification deviations
#define AV_EF_BUFFER (1<<2) ///< detect improper bitstream length
#define AV_EF_EXPLODE (1<<3) ///< abort decoding on minor error detection

#define AV_EF_IGNORE_ERR (1<<15) ///< ignore errors and continue
#define AV_EF_CAREFUL (1<<16) ///< consider things that violate the spec, are fast to calculate and have not been seen in the wild as errors
#define AV_EF_COMPLIANT (1<<17) ///< consider all spec non compliances as errors
#define AV_EF_AGGRESSIVE (1<<18) ///< consider things that a sane encoder should not do as an error

/**
* opaque 64-bit number (generally a PTS) that will be reordered and
* output in AVFrame.reordered_opaque
* - encoding: Set by libavcodec to the reordered_opaque of the input
* frame corresponding to the last returned packet. Only
* supported by encoders with the
* AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE capability.
* - decoding: Set by user.
*/
int64_t reordered_opaque;

/**
* Hardware accelerator in use
* - encoding: unused.
* - decoding: Set by libavcodec
*/
const struct AVHWAccel *hwaccel;

/**
* Hardware accelerator context.
* For some hardware accelerators, a global context needs to be
* provided by the user. In that case, this holds display-dependent
* data FFmpeg cannot instantiate itself. Please refer to the
* FFmpeg HW accelerator documentation to know how to fill this
* is. e.g. for VA API, this is a struct vaapi_context.
* - encoding: unused
* - decoding: Set by user
*/
void *hwaccel_context;

/**
* error
* - encoding: Set by libavcodec if flags & AV_CODEC_FLAG_PSNR.
* - decoding: unused
*/
uint64_t error[AV_NUM_DATA_POINTERS];

/**
* DCT algorithm, see FF_DCT_* below
* - encoding: Set by user.
* - decoding: unused
*/
int dct_algo;
#define FF_DCT_AUTO 0
#define FF_DCT_FASTINT 1
#define FF_DCT_INT 2
#define FF_DCT_MMX 3
#define FF_DCT_ALTIVEC 5
#define FF_DCT_FAAN 6

/**
* IDCT algorithm, see FF_IDCT_* below.
* - encoding: Set by user.
* - decoding: Set by user.
*/
int idct_algo;
#define FF_IDCT_AUTO 0
#define FF_IDCT_INT 1
#define FF_IDCT_SIMPLE 2
#define FF_IDCT_SIMPLEMMX 3
#define FF_IDCT_ARM 7
#define FF_IDCT_ALTIVEC 8
#define FF_IDCT_SIMPLEARM 10
#define FF_IDCT_XVID 14
#define FF_IDCT_SIMPLEARMV5TE 16
#define FF_IDCT_SIMPLEARMV6 17
#define FF_IDCT_FAAN 20
#define FF_IDCT_SIMPLENEON 22
#define FF_IDCT_NONE 24 /* Used by XvMC to extract IDCT coefficients with FF_IDCT_PERM_NONE */
#define FF_IDCT_SIMPLEAUTO 128

/**
* bits per sample/pixel from the demuxer (needed for huffyuv).
* - encoding: Set by libavcodec.
* - decoding: Set by user.
*/
int bits_per_coded_sample;

/**
* Bits per sample/pixel of internal libavcodec pixel/sample format.
* - encoding: set by user.
* - decoding: set by libavcodec.
*/
int bits_per_raw_sample;

/**
* low resolution decoding, 1-> 1/2 size, 2->1/4 size
* - encoding: unused
* - decoding: Set by user.
*/
int lowres;

#if FF_API_CODED_FRAME
/**
* the picture in the bitstream
* - encoding: Set by libavcodec.
* - decoding: unused
*
* @deprecated use the quality factor packet side data instead
*/
attribute_deprecated AVFrame *coded_frame;
#endif

/**
* thread count
* is used to decide how many independent tasks should be passed to execute()
* - encoding: Set by user.
* - decoding: Set by user.
*/
int thread_count;

/**
* Which multithreading methods to use.
* Use of FF_THREAD_FRAME will increase decoding delay by one frame per thread,
* so clients which cannot provide future frames should not use it.
*
* - encoding: Set by user, otherwise the default is used.
* - decoding: Set by user, otherwise the default is used.
*/
int thread_type;
#define FF_THREAD_FRAME 1 ///< Decode more than one frame at once
#define FF_THREAD_SLICE 2 ///< Decode more than one part of a single frame at once

/**
* Which multithreading methods are in use by the codec.
* - encoding: Set by libavcodec.
* - decoding: Set by libavcodec.
*/
int active_thread_type;

#if FF_API_THREAD_SAFE_CALLBACKS
/**
* Set by the client if its custom get_buffer() callback can be called
* synchronously from another thread, which allows faster multithreaded decoding.
* draw_horiz_band() will be called from other threads regardless of this setting.
* Ignored if the default get_buffer() is used.
* - encoding: Set by user.
* - decoding: Set by user.
*
* @deprecated the custom get_buffer2() callback should always be
* thread-safe. Thread-unsafe get_buffer2() implementations will be
* invalid starting with LIBAVCODEC_VERSION_MAJOR=60; in other words,
* libavcodec will behave as if this field was always set to 1.
* Callers that want to be forward compatible with future libavcodec
* versions should wrap access to this field in
* #if LIBAVCODEC_VERSION_MAJOR < 60
*/
attribute_deprecated
int thread_safe_callbacks;
#endif

/**
* The codec may call this to execute several independent things.
* It will return only after finishing all tasks.
* The user may replace this with some multithreaded implementation,
* the default implementation will execute the parts serially.
* @param count the number of things to execute
* - encoding: Set by libavcodec, user can override.
* - decoding: Set by libavcodec, user can override.
*/
int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void *arg2, int *ret, int count, int size);

/**
* The codec may call this to execute several independent things.
* It will return only after finishing all tasks.
* The user may replace this with some multithreaded implementation,
* the default implementation will execute the parts serially.
* Also see avcodec_thread_init and e.g. the --enable-pthread configure option.
* @param c context passed also to func
* @param count the number of things to execute
* @param arg2 argument passed unchanged to func
* @param ret return values of executed functions, must have space for “count” values. May be NULL.
* @param func function that will be called count times, with jobnr from 0 to count-1.
* threadnr will be in the range 0 to c->thread_count-1 < MAX_THREADS and so that no
* two instances of func executing at the same time will have the same threadnr.
* @return always 0 currently, but code should handle a future improvement where when any call to func
* returns < 0 no further calls to func may be done and < 0 is returned.
* - encoding: Set by libavcodec, user can override.
* - decoding: Set by libavcodec, user can override.
*/
int (*execute2)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg, int jobnr, int threadnr), void *arg2, int *ret, int count);

/**
* noise vs. sse weight for the nsse comparison function
* - encoding: Set by user.
* - decoding: unused
*/
int nsse_weight;

/**
* profile
* - encoding: Set by user.
* - decoding: Set by libavcodec.
*/
int profile;
#define FF_PROFILE_UNKNOWN -99
#define FF_PROFILE_RESERVED -100

#define FF_PROFILE_AAC_MAIN 0
#define FF_PROFILE_AAC_LOW 1
#define FF_PROFILE_AAC_SSR 2
#define FF_PROFILE_AAC_LTP 3
#define FF_PROFILE_AAC_HE 4
#define FF_PROFILE_AAC_HE_V2 28
#define FF_PROFILE_AAC_LD 22
#define FF_PROFILE_AAC_ELD 38
#define FF_PROFILE_MPEG2_AAC_LOW 128
#define FF_PROFILE_MPEG2_AAC_HE 131

#define FF_PROFILE_DNXHD 0
#define FF_PROFILE_DNXHR_LB 1
#define FF_PROFILE_DNXHR_SQ 2
#define FF_PROFILE_DNXHR_HQ 3
#define FF_PROFILE_DNXHR_HQX 4
#define FF_PROFILE_DNXHR_444 5

#define FF_PROFILE_DTS 20
#define FF_PROFILE_DTS_ES 30
#define FF_PROFILE_DTS_96_24 40
#define FF_PROFILE_DTS_HD_HRA 50
#define FF_PROFILE_DTS_HD_MA 60
#define FF_PROFILE_DTS_EXPRESS 70

#define FF_PROFILE_MPEG2_422 0
#define FF_PROFILE_MPEG2_HIGH 1
#define FF_PROFILE_MPEG2_SS 2
#define FF_PROFILE_MPEG2_SNR_SCALABLE 3
#define FF_PROFILE_MPEG2_MAIN 4
#define FF_PROFILE_MPEG2_SIMPLE 5

#define FF_PROFILE_H264_CONSTRAINED (1<<9) // 8+1; constraint_set1_flag
#define FF_PROFILE_H264_INTRA (1<<11) // 8+3; constraint_set3_flag

#define FF_PROFILE_H264_BASELINE 66
#define FF_PROFILE_H264_CONSTRAINED_BASELINE (66|FF_PROFILE_H264_CONSTRAINED)
#define FF_PROFILE_H264_MAIN 77
#define FF_PROFILE_H264_EXTENDED 88
#define FF_PROFILE_H264_HIGH 100
#define FF_PROFILE_H264_HIGH_10 110

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上Go语言开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以戳这里获取

func
* returns < 0 no further calls to func may be done and < 0 is returned.
* - encoding: Set by libavcodec, user can override.
* - decoding: Set by libavcodec, user can override.
*/
int (*execute2)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg, int jobnr, int threadnr), void *arg2, int *ret, int count);