文章目录
- [一、av_packet_ref 函数](#一、av_packet_ref 函数)
- [二、av_packet_clone 函数](#二、av_packet_clone 函数)
FFmpeg 4.0 版本源码地址 :
- GitHub : https://github.com/FFmpeg/FFmpeg/tree/release/4.0
- GitCode : https://gitcode.com/gh_mirrors/ff/FFmpeg/tree/release/4.0
- FFmpeg/libavcodec/avpacket.c 源码 : https://gitcode.com/gh_mirrors/ff/FFmpeg/blob/release/4.0/libavcodec/avpacket.c
一、av_packet_ref 函数
1、函数原型
av_packet_ref 函数 用于 将 源 AVPacket 结构体的属性 和 buf 数据引用 拷贝复制给 目标 AVPacket 结构体 , AVPacket 中的 实际数据 不会进行复制 , 新创建的 AVPacket 只会复制 实际音视频数据的 指针地址 , 函数原型如下 :
cpp
int av_packet_ref(AVPacket *dst, const AVPacket *src)-
函数功能 :
- 将 src 的 结构体字段 复制到 dst ;
- 拷贝 数据的引用 , 并增加 src 中底层数据的引用计数 ; 拷贝的是引用 , 不会对 src 中的实际数据缓冲区进行内存复制 , 避免不必要的性能开销 ;
-
参数解析 :
- AVPacket *dst 参数 : 指向 目标 AVPacket 的指针 , 被赋值的对象 ;
- const AVPacket *src 参数 : 指向 源 AVPacket 的指针 , 数据源 , 被拷贝的对象 ;
-
返回值 :
- 拷贝成功 , 返回 0 ;
- 拷贝失败 , 返回 负值 , 该负值表示错误码 ;
2、函数源码分析
av_packet_ref 函数的源码如下 :
- 分析该函数的源码可知 , 该函数执行两个操作 , 分别是 :
- 第一步 : 复制 源 结构体 中的 字段值 到 目标结构体 中 ;
- 第二步 : 将 原结构体 的 数据缓冲区 引用 赋值给 目标 数据缓冲区 引用 , 注意 这里 只 复制引用 , 不复制数据 ;
- 该函数中直接为 AVPacket 结构体字段辅助 , 因此执行该函数之前 , 目标 AVPacket 必须是已经分配好内存 ;
cpp
int av_packet_ref(AVPacket *dst, const AVPacket *src)
{
int ret;
// 复制源包（src）的属性到目标包（dst），包括时间戳、流索引等元数据。
ret = av_packet_copy_props(dst, src);
if (ret < 0) // 如果属性复制失败，则返回错误码。
return ret;
// 检查源包是否有缓冲区 (buf)，如果没有，说明需要分配新的缓冲区。
if (!src->buf) {
// 为目标包分配缓冲区，大小为源包的数据大小。
ret = packet_alloc(&dst->buf, src->size);
if (ret < 0) // 如果缓冲区分配失败，跳转到错误处理。
goto fail;
// 如果源包的数据大小不为 0，将数据从源包复制到目标包的缓冲区。
if (src->size)
memcpy(dst->buf->data, src->data, src->size);
// 将目标包的 data 指针指向分配的缓冲区。
dst->data = dst->buf->data;
} else {
// 如果源包有缓冲区，通过引用计数创建缓冲区的引用。
dst->buf = av_buffer_ref(src->buf);
if (!dst->buf) { // 如果引用创建失败，返回内存分配错误。
ret = AVERROR(ENOMEM);
goto fail;
}
// 目标包的 data 指针直接指向源包的 data。
dst->data = src->data;
}
// 将源包的大小复制到目标包。
dst->size = src->size;
// 如果执行成功，返回 0。
return 0;
fail:
// 如果发生错误，释放目标包的附加数据（如 side data）以防止资源泄漏。
av_packet_free_side_data(dst);
return ret; // 返回错误码。
}3、函数使用代码示例
代码示例 :
cpp
#include <libavcodec/avcodec.h>
#include <libavformat/avformat.h>
int main() {
AVPacket src_pkt, dst_pkt;
// 初始化源包和目标包
// av_init_packet 初始化 AVPacket 结构体，为其成员赋初始值。
av_init_packet(&src_pkt);
av_init_packet(&dst_pkt);
// 为源包分配内存并假设数据已填充
// src_pkt.data 指向分配的 100 字节内存，用于模拟填充数据。
src_pkt.data = av_malloc(100);
src_pkt.size = 100; // 数据大小设置为 100 字节。
// 创建引用
// av_packet_ref 创建目标包 dst_pkt 对源包 src_pkt 的引用。
// 如果失败，打印错误信息并返回 -1。
if (av_packet_ref(&dst_pkt, &src_pkt) < 0) {
fprintf(stderr, "Failed to create packet reference.\n");
return -1;
}
// 此时，src_pkt 和 dst_pkt 共享同一底层数据
// 打印源包和目标包的数据大小以验证共享关系。
printf("src size: %d, dst size: %d\n", src_pkt.size, dst_pkt.size);
// 释放引用
// 使用 av_packet_unref 释放源包和目标包的引用，减少引用计数。
av_packet_unref(&src_pkt);
av_packet_unref(&dst_pkt);
return 0;
}二、av_packet_clone 函数
1、函数原型
av_packet_clone 函数 用于 克隆一个完整的 AVPacket , 该函数实际上相当于 av_packet_alloc 函数 + av_packet_ref 函数 ;
cpp
AVPacket *av_packet_clone(const AVPacket *src)- const AVPacket *src 参数 : 指向 需要克隆的源 AVPacket 的指针 ;
- 返回值 :
- 拷贝成功 : 返回一个指向 新克隆的 AVPacket 的指针 ;
- 拷贝失败 : 返回 NULL , 通常是因为内存分配失败 ;
2、函数源码分析
在下面的 av_packet_clone 函数源码中可以分析处 , av_packet_clone 函数相当于
av_packet_alloc 函数 和 av_packet_ref 函数 的总体效果 ;
在 av_packet_clone 函数中 , 先调用了 av_packet_alloc 函数 , 创建 目标 AVPacket ,
然后调用 av_packet_ref 函数 , 将 源 AVPacket 的 数据拷贝给 目标 AVPacket ;
cpp
AVPacket *av_packet_clone(const AVPacket *src)
{
// 为克隆的包分配内存并初始化。
// 调用 av_packet_alloc 返回一个新的 AVPacket 指针，默认值为初始状态。
AVPacket *ret = av_packet_alloc();
// 如果分配失败，直接返回 NULL。
if (!ret)
return ret;
// 使用 av_packet_ref 函数将源包 src 的数据和元信息复制到新包 ret 中。
// av_packet_ref 返回非零值表示复制失败。
if (av_packet_ref(ret, src))
// 如果复制失败，释放已分配的 AVPacket，并将 ret 置为 NULL。
av_packet_free(&ret);
// 返回克隆后的 AVPacket 指针（成功）或 NULL（失败）。
return ret;
}