【FFmpeg】FFmpeg 内存结构 ⑥ ( 搭建开发环境 | AVPacket 创建与释放代码分析 | AVPacket 内存使用注意事项 )

韩曙亮2024-12-13 14:44

文章目录

  • 一、搭建开发环境
  • [二、AVPacket 创建与释放代码分析](#二、AVPacket 创建与释放代码分析)
    • [1、AVPacket 创建与释放代码](#1、AVPacket 创建与释放代码)
    • [2、Qt 单步调试方法](#2、Qt 单步调试方法)
    • [3、单步调试 - 分析 AVPacket 创建与销毁代码](#3、单步调试 - 分析 AVPacket 创建与销毁代码)
  • [三、AVPacket 内存使用注意事项](#三、AVPacket 内存使用注意事项)
    • [1、谨慎使用 av_init_packet 函数](#1、谨慎使用 av_init_packet 函数)
    • [2、av_init_packet 函数弃用](#2、av_init_packet 函数弃用)
    • [3、av_init_packet 函数导致内存泄漏的反面示例](#3、av_init_packet 函数导致内存泄漏的反面示例)
    • [4、av_packet_move_ref 函数 后可以使用 av_init_packet 函数](#4、av_packet_move_ref 函数 后可以使用 av_init_packet 函数)
    • [5、av_packet_clone 函数 后不可以使用 av_init_packet 函数](#5、av_packet_clone 函数 后不可以使用 av_init_packet 函数)
    • [6、av_packet_ref 函数 与 av_packet_unref 函数 成对使用](#6、av_packet_ref 函数 与 av_packet_unref 函数 成对使用)

FFmpeg 4.0 版本源码地址 :

一、搭建开发环境

开发前 , 先回顾下 开发环境 和 项目 搭建流程 ;

1、开发环境搭建参考

开发环境搭建参考如下博客 :

2、项目搭建

参考 【FFmpeg】Windows 10 平台 FFmpeg 开发环境搭建 ④ ( FFmpeg 开发库 | 创建项目导入并配置 FFmpeg 开发库 | 拷贝 DLL 动态库到 SysWOW64 目录) 博客后半部分内容 :

  • 创建 Qt 项目 : 选择 " Non-Qt Project " 下的 " Plain C Application " 类型的项目 , 构建系统使用默认的 qmake , 构建套件选择 MSVC2015 套件 ;

  • 拷贝头文件和库函数 : 将 ffmpeg-4.2.1-win32-dev 开发库目录 , 拷贝到 Qt 工程目录下 , 其中是 FFmpeg 的头文件和库函数 ;

  • 配置 头文件和库函数 : 在 .pro 配置文件 , 配置 上面拷贝的 头文件 和 函数库 , 完整配置内容如下 :

javascript 复制代码 
TEMPLATE = app
CONFIG += console
CONFIG -= app_bundle
CONFIG -= qt

SOURCES += main.c

win32 {
INCLUDEPATH += $$PWD/ffmpeg-4.2.1-win32-dev/include
LIBS += $$PWD/ffmpeg-4.2.1-win32-dev/lib/avformat.lib \
$$PWD/ffmpeg-4.2.1-win32-dev/lib/avcodec.lib \
$$PWD/ffmpeg-4.2.1-win32-dev/lib/avdevice.lib \
$$PWD/ffmpeg-4.2.1-win32-dev/lib/avfilter.lib \
$$PWD/ffmpeg-4.2.1-win32-dev/lib/avutil.lib \
$$PWD/ffmpeg-4.2.1-win32-dev/lib/postproc.lib \
$$PWD/ffmpeg-4.2.1-win32-dev/lib/swresample.lib \
$$PWD/ffmpeg-4.2.1-win32-dev/lib/swscale.lib
}
  • 代码引入头文件 : 引入 FFmpeg 库 , 并调用 av_version_info 函数 , 获取 FFmpeg 版本号 ;
cpp 复制代码 
#include <stdio.h>                  // 引入标准输入输出头文件
#include "libavutil/avutil.h"        // 引入FFmpeg库中的avutil头文件，avutil包含一些工具函数

int main()
{
    // 输出 "Hello World" 到控制台
    printf("Hello World\n");

    // 输出 FFmpeg 的版本信息，av_version_info() 函数返回当前FFmpeg库的版本信息
    printf("FFmpeg version is %s\n", av_version_info());

    // 返回0表示程序正常结束
    return 0;
}
  • 代码运行库配置 : 将下面的文件拷贝到 C:\Windows\SysWOW64 目录 或者 项目的构建目录根目录 中 ;

二、AVPacket 创建与释放代码分析

1、AVPacket 创建与释放代码

下面的代码是 AVPacket 从声明 , 分配结构体内存 , 分配缓冲区数据内存 , 解除缓冲区数据引用 , 释放缓冲区内存 的完整过程 , 之后会单步调试 , 查看具体的数据信息 ;

cpp 复制代码 
void av_packet_1()
{
    AVPacket *pkt = NULL;    // 定义一个指向 AVPacket 结构体的指针，用于存储数据包
    int ret = 0;             // 定义一个整型变量 ret，用于存储函数的返回值

    // 分配一个新的 AVPacket，返回一个指向该数据包的指针
    pkt = av_packet_alloc();

    // 为数据包分配内存，并初始化引用计数为1
    ret = av_new_packet(pkt, MEM_ITEM_SIZE);

    // 使用 memccpy 函数将 av_packet_1 的数据拷贝到 pkt->data 中
    // 从 pkt->data 地址开始，复制 MEM_ITEM_SIZE 字节的数据
    // 复制的数据来源是当前函数 av_packet_1 的地址
    memccpy(pkt->data, (void *)&av_packet_1, 1, MEM_ITEM_SIZE);

    // 解除数据包的引用，减少引用计数
    av_packet_unref(pkt);

    // 释放数据包所占的内存，并将 pkt 指针设置为 NULL
    av_packet_free(&pkt);
}

2、Qt 单步调试方法

单步调试上述代码 :

  • 在函数第一行代码位置打上断点 :

  • 点击左下角的 " Start debugging of startup project " 按钮 ,

3、单步调试 - 分析 AVPacket 创建与销毁代码

再次回到代码模式 , 即可进行单步调试 , 目前代码停留在函数的第三行代码处 ;

此时可以看到 , 声明的 AVPacket 结构体指针值为 0 , 暂时没有赋值 ;

继续下一步单步调试 , 执行 av_packet_alloc 函数 , 结果如下 , 该函数为 AVPacket 指针分配了内存 , AVPacket 结构体的成员都设置了默认值 , 其中 buf 缓冲区 被设置为了 0 , 也就是 NULL , 暂时没有进行初始化 ;

av_packet_alloc 函数 的 作用 是 : 在 堆内存中 , 为其分配内存空间 , 并为其成员设置默认值 ;

继续执行下一步 , 调用 av_new_packet 函数时 , 开始为 AVPacket 的数据分配内存 , 并将引用计数设置为 1 ;

此时 AVBuffer 结构体的 AVBufferRef *buf 成员 有了指向 , 不再是 NULL ;

真实的数据是 AVBufferRef 结构体的 AVBuffer *buffer 成员 中 , 其真实数据 和 引用计数 都在该结构体中 , 目前可以看到该结构体在堆内存中的地址是 0xec5240 ;

执行 memccpy 函数 , 设置数据缓冲区中的数据 , 执行后 , 发现数据发生了改变 ;

继续向后执行 , 执行 av_packet_unref 函数 , 解除 AVPacket 数据包引用 , 减少引用计数 ;

参考 【FFmpeg】FFmpeg 内存结构 ④ ( AVPacket 函数简介 | av_packet_unref 函数 | av_packet_move_ref 函数 ) 博客 中的 av_packet_unref 函数 分析章节 ;

最后 执行 av_packet_free 函数 , 释放 AVPacket 结构体 及其 内部的成员 所占用的内存空间 ;

执行完毕后 , 发现 AVPacket 结构体指针的值被置空 ;

三、AVPacket 内存使用注意事项

1、谨慎使用 av_init_packet 函数

av_init_packet 函数 内容如下 , 分析下面的代码 , 可知 该函数会将所有的字段都设置为 默认值 , 尤其是 pkt->buf 字段 , 这是数据缓冲区的引用 , 使用该函数不当 , 可以会导致数据缓冲区内存泄漏 ;

cpp 复制代码 
// 初始化 AVPacket 结构体
void av_init_packet(AVPacket *pkt)
{
    // 设置显示时间戳 (PTS) 为未定义值
    pkt->pts                  = AV_NOPTS_VALUE;

    // 设置解码时间戳 (DTS) 为未定义值
    pkt->dts                  = AV_NOPTS_VALUE;

    // 设置文件中的位置为 -1 (表示未知)
    pkt->pos                  = -1;

    // 设置帧的时长为 0
    pkt->duration             = 0;

#if FF_API_CONVERGENCE_DURATION
    // 以下代码处理弃用字段 convergence_duration 的初始化
    FF_DISABLE_DEPRECATION_WARNINGS
    pkt->convergence_duration = 0; // 设置帧的收敛时间为 0 (已废弃字段)
    FF_ENABLE_DEPRECATION_WARNINGS
#endif

    // 设置标志位为 0 (表示无标志)
    pkt->flags                = 0;

    // 设置流索引为 0 (初始化为默认值)
    pkt->stream_index         = 0;

    // 将引用的缓冲区指针设为 NULL
    pkt->buf                  = NULL;

    // 将侧数据的指针设为 NULL
    pkt->side_data            = NULL;

    // 设置侧数据元素个数为 0
    pkt->side_data_elems      = 0;
}

2、av_init_packet 函数弃用

av_init_packet 函数 已经弃用 , FFmpeg 官方不再建议调用该函数 , 可参考 【FFmpeg】FFmpeg 内存结构 ② ( AVPacket 函数简介 | av_packet_alloc 函数 | av_packet_free 函数 | av_new_packet 函数 ) 博客 ,

av_packet_alloc 函数 是 FFmpeg 官方推荐使用的 初始化 AVPacket 结构体的函数 , 并且建议与 av_packet_free 函数 配对使用 ;

av_packet_alloc 函数 中 调用了 av_init_packet 函数 , 已经包含了 av_init_packet 函数的功能 ;

3、av_init_packet 函数导致内存泄漏的反面示例

在下面的代码中 , 在数据释放之前的某个时间点 调用了 av_init_packet 函数 , 导致 AVPacket 的 buf 缓冲区提前置空 , 但是 buf 指向的数据缓冲区还没有释放 , 这段内存就出现了泄漏 , 再也无法进行释放 ;

cpp 复制代码 
void av_packet_1()
{
    AVPacket *pkt = NULL;    // 定义一个指向 AVPacket 结构体的指针，用于存储数据包
    int ret = 0;             // 定义一个整型变量 ret，用于存储函数的返回值

    // 分配一个新的 AVPacket，返回一个指向该数据包的指针
    pkt = av_packet_alloc();

    // 为数据包分配内存，并初始化引用计数为1
    ret = av_new_packet(pkt, MEM_ITEM_SIZE);

    // 使用 memccpy 函数将 av_packet_1 的数据拷贝到 pkt->data 中
    // 从 pkt->data 地址开始，复制 MEM_ITEM_SIZE 字节的数据
    // 复制的数据来源是当前函数 av_packet_1 的地址
    memccpy(pkt->data, (void *)&av_packet_1, 1, MEM_ITEM_SIZE);

    // 如果在数据释放之前的某个时间点 调用了 av_init_packet 函数
    // 就会导致 AVPacket 的 buf 缓冲区置空
    // 但是 buf 指向的数据缓冲区还没有释放 这段内存就出现了泄漏 再也无法进行释放
    // 此处调用 av_init_packet 函数 就会导致内存泄漏 ☆☆☆
    av_init_packet(pkt);

    // 解除数据包的引用，减少引用计数
    av_packet_unref(pkt);

    // 释放数据包所占的内存，并将 pkt 指针设置为 NULL
    av_packet_free(&pkt);
}

4、av_packet_move_ref 函数 后可以使用 av_init_packet 函数

av_packet_move_ref 函数 的 源码如下 :

cpp 复制代码 
void av_packet_move_ref(AVPacket *dst, AVPacket *src)
{
    *dst = *src;
    av_init_packet(src);
    src->data = NULL;
    src->size = 0;
}

参考 https://raw.gitcode.com/gh_mirrors/ff/FFmpeg/raw/release%2F4.0/libavcodec/avpacket.c 源码 ;

在 av_packet_move_ref 函数中 , 调用了 av_init_packet 函数 , 如果在之后继续调用一次 av_init_packet 函数 , 是不会对内存结构产生影响的 , 相当于调用了两次 av_init_packet 函数 ;

5、av_packet_clone 函数 后不可以使用 av_init_packet 函数

av_packet_clone 函数 源码如下 :

cpp 复制代码 
// 克隆一个 AVPacket
AVPacket *av_packet_clone(const AVPacket *src)
{
    // 分配一个新的 AVPacket 对象
    AVPacket *ret = av_packet_alloc();

    // 如果分配失败，直接返回 NULL
    if (!ret)
        return ret;

    // 复制源数据包 (src) 的内容到新分配的数据包 (ret)
    // 如果复制失败，释放新分配的数据包内存
    if (av_packet_ref(ret, src))
        av_packet_free(&ret);

    // 返回克隆的数据包指针 (如果成功，则指向新数据包；失败则返回 NULL)
    return ret;
}

av_packet_clone 函数 相当于 av_packet_alloc 函数 + av_packet_ref 函数 的 组合函数 ;

调用完 av_packet_clone 函数 后 , 引用计数会增加 1 , 如果原来引用计数是 1 , 则新的引用计数是 2 ;

如果在 av_packet_clone 函数 后 调用 av_init_packet 函数 , 会导致新的 AVPacket 的 buf 成员被置空 , 之后 调用 av_packet_free 函数 无法访问到 AVPacket 的 buf 成员 , 自然无法将引用计数自减 1 , 这样就导致了 内存泄漏 ;

6、av_packet_ref 函数 与 av_packet_unref 函数 成对使用

av_packet_ref 函数 和 av_packet_unref 函数 需要成对使用 , 它们的主要目的是对 AVPacket 对象的引用计数进行管理 , 从而避免内存泄漏或重复释放 ;

在使用 av_packet_ref 引用数据包时 , 引用计数会增加 ;

如果在某些地方不再需要这个引用 , 必须使用 av_packet_unref 释放它 ;

否则 , 会导致内存泄漏 ;

相关推荐
cuijiecheng20185 小时前
音视频入门基础：MPEG2-TS专题（13）——FFmpeg源码中，解析Section Header的实现
ffmpeg·音视频
我才是一卓7 小时前
linux 编译、交叉编译 opencv+ffmpeg 为动态库
linux·opencv·ffmpeg
2401_841147128 小时前
喜报！飞利浦电视通过中国音视频产业大会（AVF）产品创新鉴定！
人工智能·音视频·生活·娱乐·智能电视
PsEmperor9 小时前
mp4影像和m4a音频无损合成视频方法
音视频·视频编解码
CourseMaker蒙以微课.蒋朝华11 小时前
Rnnoise和SpeexDsp两种降噪方式有什么区别？
音视频·音频
魏+Mtiao15_12 小时前
矩阵源代码部署与功能简介
人工智能·python·线性代数·矩阵·php·音视频
飞飞-躺着更舒服14 小时前
FFmpeg 解复用过程
ffmpeg·音视频
Rox_Lee14 小时前
ffmpeg使用自定义字体添加字幕
ffmpeg
热门推荐
01游戏内存优化02【halcon】halcon字符识别——OCR03玄机平台应急响应—webshell查杀04WPS-0DAY-20230809的分析和利用复现05量化方法怎么选？如何评估量化后的大模型LLM？06(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明07AI AIgents时代-(三.)AutoGPT和AgentGPT08某红书旋转滑块验证码分析与协议算法实现（高通过率）09Docker 夺命连环 15 问10纯干货|AI辅助写论文的正确打开方式！