当前位置：首页 > news >正文

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

news 2025/10/20 9:11:21

1、avcodec_send_packet函数定义

avcodec_send_packet 是 FFmpeg 多媒体处理框架中的核心函数，属于其解码 API 的关键组成部分。
其主要功能是解码器输入函数：负责向解码器提交压缩数据包（AVPacket），现代解码 API 核心：取代旧版 avcodec_decode_video2/avcodec_decode_audio4 所属模块：libavcodec 库（编解码器核心库）。

int avcodec_send_packet(AVCodecContext *avctx, const AVPacket *avpkt)

attribute_align_arg：编译器属性，确保栈对齐（x86架构重要优化）
返回值：int 类型错误码（0=成功，负值=错误）
参数：
- avctx：编解码器上下文，包含解码器状态和配置
- avpkt：输入数据包（可为NULL表示刷新解码器）

2、avcodec_send_packet函数流程分析

2.1 参数验证阶段

检查编解码器是否已打开：!avcodec_is_open(avctx)
检查是否为解码器：!av_codec_is_decoder(avctx->codec)
无效数据包检查：avpkt && !avpkt->size && avpkt->data

2.2 状态检查

如果正在draining（刷新状态）：dc->draining_started，直接返回AVERROR_EOF

2.3 数据包处理

当收到有效数据包时（有数据或边数据）：
- 检查内部缓冲区是否为空：!AVPACKET_IS_EMPTY(avci->buffer_pkt)
- 如果缓冲区非空，返回EAGAIN（要求先处理缓冲帧）
- 缓冲区为空则复制数据包：av_packet_ref(avci->buffer_pkt, avpkt)
当收到空包（draining信号）：
- 设置dc->draining_started = 1 开始刷新解码器

2.4 解码触发

检查缓冲区帧是否为空：!avci->buffer_frame->buf[0]
检查是否非draining状态：!dc->draining_started
满足条件时调用decode_receive_frame_internal()

2.5 返回结果

成功返回0
错误返回相应错误码
具体源码分析如下：

int avcodec_send_packet(AVCodecContext *avctx, const AVPacket *avpkt)
{// 获取内部结构体指针AVCodecInternal *avci = avctx->internal;DecodeContext     *dc = decode_ctx(avci);int ret;// 1. 基本参数校验if (!avcodec_is_open(avctx) || !av_codec_is_decoder(avctx->codec))return AVERROR(EINVAL);// 2. 检查draining状态if (dc->draining_started)return AVERROR_EOF;// 3. 数据包有效性检查if (avpkt && !avpkt->size && avpkt->data)return AVERROR(EINVAL);// 4. 有效数据包处理if (avpkt && (avpkt->data || avpkt->side_data_elems)) {// 4.1 检查缓冲区是否已满if (!AVPACKET_IS_EMPTY(avci->buffer_pkt))return AVERROR(EAGAIN);// 4.2 复制数据包到内部缓冲区ret = av_packet_ref(avci->buffer_pkt, avpkt);if (ret < 0)return ret;} // 5. 处理draining信号（空包）else {dc->draining_started = 1;}// 6. 触发解码（非draining状态且缓冲区有空位）if (!avci->buffer_frame->buf[0] && !dc->draining_started) {ret = decode_receive_frame_internal(avctx, avci->buffer_frame);// 只处理严重错误（忽略EAGAIN和EOF）if (ret < 0 && ret != AVERROR(EAGAIN) && ret != AVERROR_EOF)return ret;}return 0;
}