avformat_alloc_output_context2源码

/**
 * 为输出格式分配AVFormatContext,使用avformat_free_context()释放
 * @param *ctx 输出参数，创建好的 AVFormatContext*对象将会由该参数传递出来
 *                       如果分配失败，则NULL
 * 后面的三个参数，按着优先级，决定着*ctx的创建，如果oformat是null，则
 * format_name和filename起作用，如果foramt_name是空，则由filename起作用
 */
int avformat_alloc_output_context2(AVFormatContext **ctx, 
                                   AVOutputFormat *oformat,
                                   const char *format_name, 
                                   const char *filename);

API使用场景

AVFormatContext *ofmt_ctx = NULL;
avformat_alloc_output_context2(&ofmt_ctx, NULL, NULL, out_filename);
//或
avformat_alloc_output_context2(&ofmt_ctx, NULL, "mpeg", out_filename);

这个函数主要作用就是根据后面的三个参数，来创建ofmt_ctx对象。

内部实现

如果让我们来实现这个逻辑该如何做？既然ctx是一个传出参数，因此完成这个过程，总体上应该分为步骤。1. 为AVFormatContext分配内存空间。2. 初始化AVFormatContext 成员属性。

1. 分配内存空间

AVFormatContext *s = avformat_alloc_context();

2. 初始化成员

这里需要弄清楚两个问题，a. 具体哪些成员需要初始化？b. 依据什么初始化？

想要解决第一个问题，我们需要知道使用这个API的场景是什么，一般，我们调用这个api的目的是为了将音视频流封装成媒体容器格式文件。而AVFormatContext则存放着该封装格式的具体信息。因此我们需要初始化的第一个成员变量就是AVOutputFormat *oformat。

初始化AVOutputForamt成员

根据avformat_alloc_output_context2的API描述，oformat这个对象的值可以以参数的形式由外部传入，如果第二个参数为NULL，则我们可以依据format_name和filename参数来创建生成oformat。

if(!oformat){
  if(format_name){
    oformat = av_guess_format(format, NULL, NULL);
  }else{
    oformat = av_guess_format(NULL, filename, NULL);
  }
}
s->oformat = oformat;

为了能更清晰的表述总体设计思想，上面并没有异常容错机制，例如av_guess_format可能会出现调用失败的情况。

初始化priv_data成员

if (s->oformat->priv_data_size > 0) {
  //分配内存空间
  s->priv_data = av_mallocz(s->oformat->priv_data_size);
  if (!s->priv_data)
    goto nomem;
  if (s->oformat->priv_class) {
    /*
        priv_data指向了一片内存空间，这片内存空间又被解释成多个片段。
      第一个片段存放的则是AVClass *的指针对象。而这个AVClass *指针指向
      的数据域被赋值为：s->oformat->priv_class所指向的数据域。
    */
    *(const AVClass**)s->priv_data= s->oformat->priv_class;
    //为priv_data设置默认初始值
    av_opt_set_defaults(s->priv_data);
  }
}

priv_data这个成员在AVFormatContext代表什么? 有很多处理音视频的开源库，而FFmpeg的优秀之处在于其框架的统一性和的灵活的可扩展性，FFmpeg将多种媒体类型的广义数据的共同部分抽象成Context结构，而将广义数据的不同部分抽象成各种具体的context，然后用priv_data字段的指针关联起来。例如在本篇中，我们的目的是将编码数据封装成媒体容器格式，因此AVFormatContext对象会描述所有的输出格式上下文信息，其内部使用iformat/oformat来表示该对象是输入上下文还是输出上下文，但是即使是这样，iforamt或者oformat也依然无法完全表示一个具体媒体格式的全部信息，准确的说iformat/oformat这个对象主要定义了怎样实现输入或者输出功能。不同的媒体格式有不同的参数控制信息，FFMpeg将这些信息关联到iforamt/oformat对象的priv_class字段中，这是一个AVClass的结构体指针，它内部指向到一个预制参数静态数组（options），而priv_data的作用就是将这个静态结构数组里的各个选项的值，解析并存储到priv_data中。