FFmpeg 基本API avformat_alloc_context 函数内部调用流程分析

1、avformat_alloc_context 函数定义

avformat_alloc_context 是 FFmpeg 库中的一个函数，用于分配并初始化一个 AVFormatContext 结构体的指针。在使用 FFmpeg 进行音视频处理时，通常需要先调用这个函数来创建一个 AVFormatContext 对象。

函数原型如下：

cpp 复制代码

AVFormatContext *avformat_alloc_context(void)
{
    // 1. 分配FFFormatContext结构体
    FFFormatContext *const si = av_mallocz(sizeof(*si));
    AVFormatContext *s;

    // 2. 初始化FFFormatContext结构体
    s = &si->pub;
    s->av_class = &av_format_context_class;
    
    // 3. 设置默认的io_open和io_close2函数
    s->io_open  = io_open_default;
    s->io_close2= io_close2_default;

    // 4. 设置默认的选项
    av_opt_set_defaults(s);
    // 5. 分配AVPacket结构体
    si->pkt = av_packet_alloc();
    si->parse_pkt = av_packet_alloc();
    return s;
}

在使用完 AVFormatContext 对象后，可以通过调用 void avformat_free_context(AVFormatContext *s) 函数来释放分配的内存。

2、avformat_alloc_context分配主要流程

avformat_alloc_context() 关键流程:

分配 AVFormatContext
初始化内部成员（AVIOContext 为 NULL）
设置默认参数：start_time, duration, packet_size, probesize, max_analyze_duration 等
分配 AVFormatInternal 并初始化子字段
分配 AVStreamList 等辅助结构（部分版本在 open 时延后）

3、avformat_alloc_context与avformat_open_input() / avformat_free_context() 的关系

avformat_alloc_context()：只分配并做最小初始化。
avformat_open_input(&ic, url, iformat, options)：
- 如果 *ic 为 NULL，avformat_open_input() 会内部调用 avformat_alloc_context() 来创建。
- avformat_open_input() 会做真正的"打开和初始化"：探测格式、分配 pb（如果必要）、分配 demuxer 私有数据（ic->priv_data / iformat->priv_data）、调用 read_header 回调并填充 streams 等。
- 如果 avformat_open_input() 失败，它会清理分配的资源（包括释放 ic，除非你传入已分配的 ic 并指定了不同的行为------实现细节随版本）。因此常见用法是把 ic 初始化为 NULL，直接把 &ic 交给 avformat_open_input()，让它负责分配与回滚。
avformat_free_context(AVFormatContext *s)：释放 AVFormatContext 和已分配资源（streams、metadata、pb 等），适用于你只调用了 avformat_alloc_context() 或你想手动释放。另外 avformat_close_input() 是更常用的对输入 context 的清理方式（它会调用 avformat_free_context() 并关闭 I/O）

4、avformat_alloc_context初始化参数列表

AVFormatContext的初始化列表参数定义在 libavformat\options_table.h avformat_options中，其中比较重要如下：