Linux FFmpeg深度解析之avcodec_default_get_buffer2调用流程与实战(二十)

Android系统攻城狮2026-11-03 9:15

简介： CSDN博客专家、《Android系统多媒体进阶实战》作者

博主新书推荐：《Android系统多媒体进阶实战》🚀

Android Audio工程师专栏地址：Audio工程师进阶系列【原创干货持续更新中...... 】🚀

Android多媒体专栏地址：多媒体系统工程师系列【原创干货持续更新中...... 】🚀

专题一 二：AAOS车载系统+AOSP14系统攻城狮入门视频实战课 🚀

专题三：Android14 Binder之HIDL与AIDL通信实战课 🚀

专题四：Android15快速自定义与集成音效实战课 🚀

专题五：Android15音频策略实战课 🚀

专题六：Android15音频性能实战课(无声/杂音/断音/爆音实战案例) 🚀

人生格言： 人生从来没有捷径，只有行动才是治疗恐惧和懒惰的唯一良药.
更多原创,欢迎关注：Android系统攻城狮

点击获取二维码

🍉🍉🍉文章目录🍉🍉🍉

🌻1.前言

本篇目的：理解avcodec_default_get_buffer2()如何为AVFrame分配带引用计数的音视频缓冲区，并梳理解码器回调、内部缓冲池与帧数据之间的关系。

解码器处理压缩数据时，需要为解码后的帧准备数据平面。avcodec_default_get_buffer2()是FFmpeg提供的默认缓冲分配实现，通常由AVCodecContext.get_buffer2调用。它负责申请和填充AVFrame的数据缓冲，不负责解析码流或执行解码。
#mermaid-svg-map9uUZnw7Jhlydz{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-map9uUZnw7Jhlydz .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-map9uUZnw7Jhlydz .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-map9uUZnw7Jhlydz .error-icon{fill:#552222;}#mermaid-svg-map9uUZnw7Jhlydz .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-map9uUZnw7Jhlydz .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-map9uUZnw7Jhlydz .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-map9uUZnw7Jhlydz .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-map9uUZnw7Jhlydz .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-map9uUZnw7Jhlydz .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-map9uUZnw7Jhlydz .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-map9uUZnw7Jhlydz .marker{fill:#333333;stroke:#333333;}#mermaid-svg-map9uUZnw7Jhlydz .marker.cross{stroke:#333333;}#mermaid-svg-map9uUZnw7Jhlydz svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-map9uUZnw7Jhlydz p{margin:0;}#mermaid-svg-map9uUZnw7Jhlydz .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-map9uUZnw7Jhlydz .cluster-label text{fill:#333;}#mermaid-svg-map9uUZnw7Jhlydz .cluster-label span{color:#333;}#mermaid-svg-map9uUZnw7Jhlydz .cluster-label span p{background-color:transparent;}#mermaid-svg-map9uUZnw7Jhlydz .label text,#mermaid-svg-map9uUZnw7Jhlydz span{fill:#333;color:#333;}#mermaid-svg-map9uUZnw7Jhlydz .node rect,#mermaid-svg-map9uUZnw7Jhlydz .node circle,#mermaid-svg-map9uUZnw7Jhlydz .node ellipse,#mermaid-svg-map9uUZnw7Jhlydz .node polygon,#mermaid-svg-map9uUZnw7Jhlydz .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-map9uUZnw7Jhlydz .rough-node .label text,#mermaid-svg-map9uUZnw7Jhlydz .node .label text,#mermaid-svg-map9uUZnw7Jhlydz .image-shape .label,#mermaid-svg-map9uUZnw7Jhlydz .icon-shape .label{text-anchor:middle;}#mermaid-svg-map9uUZnw7Jhlydz .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-map9uUZnw7Jhlydz .rough-node .label,#mermaid-svg-map9uUZnw7Jhlydz .node .label,#mermaid-svg-map9uUZnw7Jhlydz .image-shape .label,#mermaid-svg-map9uUZnw7Jhlydz .icon-shape .label{text-align:center;}#mermaid-svg-map9uUZnw7Jhlydz .node.clickable{cursor:pointer;}#mermaid-svg-map9uUZnw7Jhlydz .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-map9uUZnw7Jhlydz .arrowheadPath{fill:#333333;}#mermaid-svg-map9uUZnw7Jhlydz .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-map9uUZnw7Jhlydz .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-map9uUZnw7Jhlydz .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-map9uUZnw7Jhlydz .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-map9uUZnw7Jhlydz .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-map9uUZnw7Jhlydz .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-map9uUZnw7Jhlydz .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-map9uUZnw7Jhlydz .cluster text{fill:#333;}#mermaid-svg-map9uUZnw7Jhlydz .cluster span{color:#333;}#mermaid-svg-map9uUZnw7Jhlydz div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-map9uUZnw7Jhlydz .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-map9uUZnw7Jhlydz rect.text{fill:none;stroke-width:0;}#mermaid-svg-map9uUZnw7Jhlydz .icon-shape,#mermaid-svg-map9uUZnw7Jhlydz .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-map9uUZnw7Jhlydz .icon-shape p,#mermaid-svg-map9uUZnw7Jhlydz .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-map9uUZnw7Jhlydz .icon-shape .label rect,#mermaid-svg-map9uUZnw7Jhlydz .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-map9uUZnw7Jhlydz .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-map9uUZnw7Jhlydz .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-map9uUZnw7Jhlydz :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 解码器需要输出帧空间
get_buffer2回调
avcodec_default_get_buffer2
缓冲池提供AVBufferRef
AVFrame获得数据平面

🌻2.应用场景和用法

2.1默认帧缓冲分配场景

avcodec_default_get_buffer2()主要用于解码器准备输出帧内存，也可以作为自定义get_buffer2回调的默认实现。

场景 使用方式 作用
普通软件解码 使用默认get_buffer2回调 按音视频格式申请帧缓冲
自定义解码缓冲 自定义回调中调用默认实现 保留默认内存路径，补充自定义处理
硬件帧解码 配置hw_frames_ctx后走默认回调 由硬件帧上下文申请帧缓冲
检查解码帧内存 解码后查看AVFrame.data和AVFrame.buf 确认帧数据有对应的引用计数缓冲区

该函数不能替代avcodec_send_packet()和avcodec_receive_frame()。前者提交压缩数据，后者取得解码结果；默认缓冲函数只处理帧空间分配。

2.2函数原型与返回语义

函数原型如下：

c 复制代码 
int
avcodec_default_get_buffer2 (AVCodecContext *avctx,
                             AVFrame *frame,
                             int flags);
参数或返回值 含义
avctx 已初始化并处于解码流程中的编解码器上下文
frame 需要填充数据平面的空AVFrame
flags 缓冲请求标志；默认实现的普通软件分配路径不使用该参数
返回值 成功返回0，失败返回负的AVERROR值

调用成功后，frame->data[]指向实际数据平面，frame->buf[]保存对应的AVBufferRef。调用者不应直接释放frame->data[]，应使用av_frame_unref()或av_frame_free()释放帧持有的引用。

自定义缓冲回调可以在需要时委托给默认实现：

c 复制代码 
static int
custom_get_buffer2 (AVCodecContext *avctx, AVFrame *frame, int flags)
{
  /* 自定义分配路径不适用时，回退到FFmpeg默认实现 */
  return avcodec_default_get_buffer2 (avctx, frame, flags);
}

AVCodecContext.get_buffer2由avcodec_alloc_context3()初始化为默认回调。自定义实现若不直接提供符合要求的AVBufferRef和数据平面，就应根据解码器能力约束调用默认实现。

🌻3.调用流程剖析

3.1从编解码器上下文进入默认回调

解码器准备一帧输出数据时，内部帧缓冲流程会调用avctx->get_buffer2()。默认配置下，这个回调指向avcodec_default_get_buffer2()。函数根据AVCodecContext中的硬件帧状态和AVFrame的媒体格式选择分配路径。
#mermaid-svg-WTCN3YwKXWjTYdFM{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-WTCN3YwKXWjTYdFM .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-WTCN3YwKXWjTYdFM .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-WTCN3YwKXWjTYdFM .error-icon{fill:#552222;}#mermaid-svg-WTCN3YwKXWjTYdFM .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-WTCN3YwKXWjTYdFM .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-WTCN3YwKXWjTYdFM .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-WTCN3YwKXWjTYdFM .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-WTCN3YwKXWjTYdFM .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-WTCN3YwKXWjTYdFM .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-WTCN3YwKXWjTYdFM .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-WTCN3YwKXWjTYdFM .marker{fill:#333333;stroke:#333333;}#mermaid-svg-WTCN3YwKXWjTYdFM .marker.cross{stroke:#333333;}#mermaid-svg-WTCN3YwKXWjTYdFM svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-WTCN3YwKXWjTYdFM p{margin:0;}#mermaid-svg-WTCN3YwKXWjTYdFM .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-WTCN3YwKXWjTYdFM .cluster-label text{fill:#333;}#mermaid-svg-WTCN3YwKXWjTYdFM .cluster-label span{color:#333;}#mermaid-svg-WTCN3YwKXWjTYdFM .cluster-label span p{background-color:transparent;}#mermaid-svg-WTCN3YwKXWjTYdFM .label text,#mermaid-svg-WTCN3YwKXWjTYdFM span{fill:#333;color:#333;}#mermaid-svg-WTCN3YwKXWjTYdFM .node rect,#mermaid-svg-WTCN3YwKXWjTYdFM .node circle,#mermaid-svg-WTCN3YwKXWjTYdFM .node ellipse,#mermaid-svg-WTCN3YwKXWjTYdFM .node polygon,#mermaid-svg-WTCN3YwKXWjTYdFM .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-WTCN3YwKXWjTYdFM .rough-node .label text,#mermaid-svg-WTCN3YwKXWjTYdFM .node .label text,#mermaid-svg-WTCN3YwKXWjTYdFM .image-shape .label,#mermaid-svg-WTCN3YwKXWjTYdFM .icon-shape .label{text-anchor:middle;}#mermaid-svg-WTCN3YwKXWjTYdFM .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-WTCN3YwKXWjTYdFM .rough-node .label,#mermaid-svg-WTCN3YwKXWjTYdFM .node .label,#mermaid-svg-WTCN3YwKXWjTYdFM .image-shape .label,#mermaid-svg-WTCN3YwKXWjTYdFM .icon-shape .label{text-align:center;}#mermaid-svg-WTCN3YwKXWjTYdFM .node.clickable{cursor:pointer;}#mermaid-svg-WTCN3YwKXWjTYdFM .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-WTCN3YwKXWjTYdFM .arrowheadPath{fill:#333333;}#mermaid-svg-WTCN3YwKXWjTYdFM .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-WTCN3YwKXWjTYdFM .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-WTCN3YwKXWjTYdFM .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-WTCN3YwKXWjTYdFM .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-WTCN3YwKXWjTYdFM .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-WTCN3YwKXWjTYdFM .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-WTCN3YwKXWjTYdFM .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-WTCN3YwKXWjTYdFM .cluster text{fill:#333;}#mermaid-svg-WTCN3YwKXWjTYdFM .cluster span{color:#333;}#mermaid-svg-WTCN3YwKXWjTYdFM div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-WTCN3YwKXWjTYdFM .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-WTCN3YwKXWjTYdFM rect.text{fill:none;stroke-width:0;}#mermaid-svg-WTCN3YwKXWjTYdFM .icon-shape,#mermaid-svg-WTCN3YwKXWjTYdFM .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-WTCN3YwKXWjTYdFM .icon-shape p,#mermaid-svg-WTCN3YwKXWjTYdFM .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-WTCN3YwKXWjTYdFM .icon-shape .label rect,#mermaid-svg-WTCN3YwKXWjTYdFM .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-WTCN3YwKXWjTYdFM .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-WTCN3YwKXWjTYdFM .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-WTCN3YwKXWjTYdFM :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 是
否
解码器准备AVFrame
读取get_buffer2回调
存在硬件帧上下文
调用硬件帧缓冲接口
更新软件帧缓冲池
返回分配结果

存在hw_frames_ctx时，函数调用av_hwframe_get_buffer()，并设置帧宽高。没有硬件帧上下文时，函数先调用update_frame_pool()，按当前帧格式和尺寸创建或复用软件缓冲池，再根据codec_type进入视频或音频分配路径。其他媒体类型会返回失败。

3.2缓冲池填充帧数据平面

视频路径根据对齐后的图像尺寸计算每个平面的行跨度和空间大小，为各平面建立AVBufferPool。分配时从缓冲池取出AVBufferRef，把其数据地址写入frame->data[]，并填充frame->linesize[]。

音频路径依据采样格式、声道布局和nb_samples计算缓冲大小。平面音频按声道数准备多个数据平面；交错音频使用一个平面。声道平面数量超过AVFrame.data[]容量时，还会分配extended_data和extended_buf保存扩展项。

缓冲池只负责复用存储空间。每个返回帧通过AVBufferRef持有缓冲区引用，因此帧的释放和缓冲池本身的销毁是两个不同的生命周期。

🌻4.实战案例

4.1准备解码器上下文和空帧

示例使用MPEG-2视频解码器创建上下文，并明确设置帧尺寸和像素格式。该例直接调用默认分配接口观察AVFrame的缓冲引用，不读取压缩视频，也不执行解码。

4.2调用默认分配并检查数据平面

成功调用后检查返回值、frame->data[0]和frame->buf[0]。这三个检查分别确认接口成功、帧数据地址存在、数据地址受引用计数缓冲区管理。

4.3完整代码
c 复制代码 
#include <libavcodec/avcodec.h>
#include <libavutil/frame.h>
#include <libavutil/pixfmt.h>

int
main (void)
{
  const AVCodec *codec = NULL;
  AVCodecContext *avctx = NULL;
  AVFrame *frame = NULL;
  int ret = 1;

  /* 查找解码器并创建编解码器上下文 */
  codec = avcodec_find_decoder (AV_CODEC_ID_MPEG2VIDEO);
  if (codec == NULL)
    goto done;

  avctx = avcodec_alloc_context3 (codec);
  if (avctx == NULL)
    goto done;

  /* 准备默认缓冲分配需要的帧尺寸和像素格式 */
  avctx->width = 320;
  avctx->height = 240;
  avctx->coded_width = 320;
  avctx->coded_height = 240;
  avctx->pix_fmt = AV_PIX_FMT_YUV420P;

  /* 打开解码器以初始化内部状态 */
  if (avcodec_open2 (avctx, codec, NULL) < 0)
    goto done;

  frame = av_frame_alloc ();
  if (frame == NULL)
    goto done;

  /* 直接调用默认实现，为空帧申请软件缓冲 */
  frame->width = avctx->width;
  frame->height = avctx->height;
  frame->format = avctx->pix_fmt;

  if (avcodec_default_get_buffer2 (avctx, frame, 0) < 0)
    goto done;

  /* 数据地址应由AVBufferRef管理 */
  if (frame->data[0] == NULL || frame->buf[0] == NULL)
    goto done;

  ret = 0;

done:
  /* 释放AVFrame持有的缓冲引用和编解码器上下文 */
  av_frame_free (&frame);
  avcodec_free_context (&avctx);

  return ret;
}

🌻5.总结

avcodec_default_get_buffer2()根据音视频帧格式从硬件接口或软件缓冲池取得帧存储，并把数据平面及其引用关系写入AVFrame。

相关推荐
honsor1 小时前
以太网温湿度传感器｜动环监控核心采集设备，协议、组网、Zabbix接入实战
linux·服务器·ubuntu
深圳恒讯1 小时前
香港云主机硬盘满了怎么办？Linux和Windows在线扩容操作教程
linux·运维·windows
饭后一颗花生米1 小时前
GitHub Actions 自动化：5 个真实运维提效案例
运维·自动化·github
十碗阳春面1 小时前
阿里云 Ubuntu 22.04 部署 Flarum 论坛：从空白服务器到中文界面、公网 IP 访问
服务器·ubuntu·阿里云
Android系统攻城狮1 小时前
Linux FFmpeg深度解析之av_parser_init调用流程与实战(二十一)
linux·运维·服务器·ffmpeg·音视频进阶·ffmpeg音视频
HideF1 小时前
Linux 查看用户和组
linux
Canmag 兴隆磁性1 小时前
钕铁硼磁片取向方向检测自动化方案：从人工目检到流水线在线分选的工程实践
运维·数据库·自动化·工业自动化·钕铁硼·自动化检测·磁材料
a5986521 小时前
ARM服务器搭建云手机靠谱吗？个人自建方案优缺点总结
服务器·arm开发·智能手机·云手机
寺中人1 小时前
CentOS 7进程与任务管理
linux·运维·centos·服务器搭建与管理·linux运维命令·nohup screen
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03GitHub 镜像站点04几个好用的ip纯净度检测网站05如何新建文件夹？ 电脑新建文件夹的4种方法06苹果iPA游戏软件资源下载网站07蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接08昇腾910B系列芯片完全指南：四款型号对比、服务器选型与大模型部署实战09微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新10Dify：一站式AI应用开发平台全解析与Windows部署指南