Linux FFmpeg深度解析之avcodec_default_get_buffer2调用流程与实战(二十)
发布时间:2026/11/3 10:36:21 锦皓数字建站
`)
简介CSDN博客专家、《Android系统多媒体进阶实战》作者博主新书推荐《Android系统多媒体进阶实战》Android Audio工程师专栏地址Audio工程师进阶系列【原创干货持续更新中……】Android多媒体专栏地址多媒体系统工程师系列【原创干货持续更新中……】专题一 二AAOS车载系统AOSP14系统攻城狮入门视频实战课专题三Android14 Binder之HIDL与AIDL通信实战课专题四Android15快速自定义与集成音效实战课专题五Android15音频策略实战课专题六Android15音频性能实战课(无声/杂音/断音/爆音实战案例)人生格言人生从来没有捷径只有行动才是治疗恐惧和懒惰的唯一良药.更多原创,欢迎关注Android系统攻城狮点击获取二维码文章目录1.前言2.应用场景和用法2.1默认帧缓冲分配场景2.2函数原型与返回语义3.调用流程剖析3.1从编解码器上下文进入默认回调3.2缓冲池填充帧数据平面4.实战案例4.1准备解码器上下文和空帧4.2调用默认分配并检查数据平面4.3完整代码5.总结1.前言本篇目的理解avcodec_default_get_buffer2()如何为AVFrame分配带引用计数的音视频缓冲区并梳理解码器回调、内部缓冲池与帧数据之间的关系。解码器处理压缩数据时需要为解码后的帧准备数据平面。avcodec_default_get_buffer2()是FFmpeg提供的默认缓冲分配实现通常由AVCodecContext.get_buffer2调用。它负责申请和填充AVFrame的数据缓冲不负责解析码流或执行解码。解码器需要输出帧空间get_buffer2回调avcodec_default_get_buffer2缓冲池提供AVBufferRefAVFrame获得数据平面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函数原型与返回语义函数原型如下intavcodec_default_get_buffer2(AVCodecContext*avctx,AVFrame*frame,intflags);参数或返回值含义avctx已初始化并处于解码流程中的编解码器上下文frame需要填充数据平面的空AVFrameflags缓冲请求标志默认实现的普通软件分配路径不使用该参数返回值成功返回0失败返回负的AVERROR值调用成功后frame-data[]指向实际数据平面frame-buf[]保存对应的AVBufferRef。调用者不应直接释放frame-data[]应使用av_frame_unref()或av_frame_free()释放帧持有的引用。自定义缓冲回调可以在需要时委托给默认实现staticintcustom_get_buffer2(AVCodecContext*avctx,AVFrame*frame,intflags){/* 自定义分配路径不适用时回退到FFmpeg默认实现 */returnavcodec_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的媒体格式选择分配路径。是否解码器准备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完整代码#includelibavcodec/avcodec.h#includelibavutil/frame.h#includelibavutil/pixfmt.hintmain(void){constAVCodec*codecNULL;AVCodecContext*avctxNULL;AVFrame*frameNULL;intret1;/* 查找解码器并创建编解码器上下文 */codecavcodec_find_decoder(AV_CODEC_ID_MPEG2VIDEO);if(codecNULL)gotodone;avctxavcodec_alloc_context3(codec);if(avctxNULL)gotodone;/* 准备默认缓冲分配需要的帧尺寸和像素格式 */avctx-width320;avctx-height240;avctx-coded_width320;avctx-coded_height240;avctx-pix_fmtAV_PIX_FMT_YUV420P;/* 打开解码器以初始化内部状态 */if(avcodec_open2(avctx,codec,NULL)0)gotodone;frameav_frame_alloc();if(frameNULL)gotodone;/* 直接调用默认实现为空帧申请软件缓冲 */frame-widthavctx-width;frame-heightavctx-height;frame-formatavctx-pix_fmt;if(avcodec_default_get_buffer2(avctx,frame,0)0)gotodone;/* 数据地址应由AVBufferRef管理 */if(frame-data[0]NULL||frame-buf[0]NULL)gotodone;ret0;done:/* 释放AVFrame持有的缓冲引用和编解码器上下文 */av_frame_free(frame);avcodec_free_context(avctx);returnret;}5.总结avcodec_default_get_buffer2()根据音视频帧格式从硬件接口或软件缓冲池取得帧存储并把数据平面及其引用关系写入AVFrame。
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。