FFmpeg引用计数数据缓冲区相关的结构体:AVBuffer、AVBufferRef简介

发布于:2024-07-05 ⋅ 阅读:(18) ⋅ 点赞:(0)

=================================================================

FFmpeg内存管理相关的源码分析:

FFmpeg中内存分配和释放相关的源码:av_malloc函数、av_mallocz函数、av_free函数和av_freep函数分析

FFmpeg引用计数数据缓冲区相关的结构体:AVBuffer、AVBufferRef简介

FFmpeg源码:buffer_create、av_buffer_create、av_buffer_default_free、av_buffer_alloc、av_buffer_allocz函数分析

FFmpeg源码:av_buffer_ref、av_buffer_unref函数分析

=================================================================

一、引言

FFmpeg源码里面很多结构体,比如AVPacket、AVFrame都使用了AVBufferRef和AVBuffer来管理缓冲区。AVBuffer里面通过成员变量refcount记录资源使用的次数,控制资源的释放。本文对AVBuffer和AVBufferRef结构体进行简介。

二、AVBuffer结构体的声明

AVBuffer是一个用于引用计数数据缓冲区的应用程序编程接口,它表示数据缓冲区本身。它是不透明的,不能被使用FFmpeg API的用户直接访问调用。用户只能通过AVBufferRef间接访问它。但是可以通过比较两个AVBuffer指针来检查是否两个不同的引用都描述了相同的数据缓冲区。

AVBuffer结构体声明在FFmpeg源码(本文演示用的FFmpeg源码版本为5.0.3)的头文件libavutil/buffer_internal.h中:

struct AVBuffer {
    uint8_t *data; /**< data described by this buffer */
    size_t size; /**< size of data in bytes */

    /**
     *  number of existing AVBufferRef instances referring to this buffer
     */
    atomic_uint refcount;

    /**
     * a callback for freeing the data
     */
    void (*free)(void *opaque, uint8_t *data);

    /**
     * an opaque pointer, to be used by the freeing callback
     */
    void *opaque;

    /**
     * A combination of AV_BUFFER_FLAG_*
     */
    int flags;

    /**
     * A combination of BUFFER_FLAG_*
     */
    int flags_internal;
};

成员变量data:指针,指向该缓冲区描述的数据。

成员变量size:data指向的缓冲区的大小,单位为字节。

成员变量refcount:refcount表示引用该缓冲区的现有AVBufferRef实例的数目(也就是引用计数),为atomic_uint(支持原子操作)的类型。atomic_uint类型表示每次操作refcount这个变量,包括读取其值、更改其值,这次操作中执行的唯一一条指令是原子的,从而保护这个变量refcount不脏读脏写,线程安全。FFmpeg源码中通过av_buffer_ref函数增加AVBuffer的引用计数,av_buffer_unref减少引用计数。

成员变量void (*free)(void *opaque, uint8_t *data):函数指针,指向释放数据的回调函数。

成员变量opaque:一个不透明的指针,提供给 释放数据的回调函数(函数指针void (*free)(void *opaque, uint8_t *data)指向的函数)的参数。

成员变量flags:AV_BUFFER_FLAG_*的组合。

成员变量flags_internal:BUFFER_FLAG_*的组合。

三、AVBufferRef结构体的声明

AVBufferRef是指向数据缓冲区的引用。这个结构体的大小不是公共应用程序二进制接口的一部分,也不意味着可以直接被分配。AVBufferRef对AVBuffer进行了一层封装,实现了安全机制。用户应通过AVBufferRef来访问AVBuffer,而不是直接访问AVBuffer,来保证安全。

AVBufferRef结构体声明在FFmpeg源码的头文件libavutil/buffer.h中:

/**
 * A reference to a data buffer.
 *
 * The size of this struct is not a part of the public ABI and it is not meant
 * to be allocated directly.
 */
typedef struct AVBufferRef {
    AVBuffer *buffer;

    /**
     * The data buffer. It is considered writable if and only if
     * this is the only reference to the buffer, in which case
     * av_buffer_is_writable() returns 1.
     */
    uint8_t *data;
    /**
     * Size of data in bytes.
     */
    size_t   size;
} AVBufferRef;

成员变量buffer:AVBuffer类型,为数据缓冲区本身。

成员变量data:数据缓冲区。当且仅当这是对缓冲区的唯一引用时,它才被认为是可写的,在这种情况下函数av_buffer_is_writable()返回1。

成员变量:data指向的缓冲区的大小,单位为字节。


网站公告

今日签到

点亮在社区的每一天
去签到