FFmpeg源码：av_packet_move_ref、av_packet_make_refcounted函数分析

一、av_packet_move_ref函数

（一）av_packet_move_ref函数的声明

av_packet_move_ref函数声明在FFmpeg源码（本文演示用的FFmpeg源码版本为7.0.1）的头文件libavcodec/packet.h中：

/*** Move every field in src to dst and reset src.** @see av_packet_unref** @param src Source packet, will be reset* @param dst Destination packet*/
void av_packet_move_ref(AVPacket *dst, AVPacket *src);

该函数作用是：类似C++11中的移动语义，将形参src指向的AVPacket对象的所有属性（包括其成员变量，src->buf、src->data、src->side_data指向的缓冲区中的数据）移动到形参dst指向的AVPacket对象中。执行该函数后，src指向的AVPacket对象会被初始化（成员变量pts、dts、pos、time_base赋默认值，其它成员变量包括指针赋值为0或NULL）。

（二）av_packet_move_ref函数的定义

av_packet_move_ref函数定义在源文件libavcodec/avpacket.c中：

void av_packet_move_ref(AVPacket *dst, AVPacket *src)
{*dst = *src;get_packet_defaults(src);
}

该函数内部，首先通过下面语句，将形参src指向的AVPacket对象（以下简称原对象）浅拷贝（这里就是模仿C++的浅拷贝）到形参dst指向的AVPacket对象（以下简称目标对象）中，通过浅拷贝只对目标对象赋值原对象的成员变量的值，并不复制原对象的动态分配内存（src->buf、src->data、src->side_data指向的缓冲区）等外部资源：

*dst = *src;

为了避免原对象修改自己指向的外部资源时，可能会影响到目标对象，通过下面语句给原对象的成员变量pts、dts、pos、time_base赋默认值，给原对象的其它成员变量包括指针值赋值为0或NULL：

get_packet_defaults(src);

可以看到，FFmpeg通过上面两个语句实现了类似C++11中的移动语义效果，实现AVPacket的所有权从原对象转移到目标对象，只是转移，没有内存的搬迁或者内存拷贝，从而极大地提高代码运行效率。

二、av_packet_make_refcounted函数

（一）av_packet_make_refcounted函数的声明

av_packet_make_refcounted函数声明在头文件libavcodec/packet.h中：

/*** Ensure the data described by a given packet is reference counted.** @note This function does not ensure that the reference will be writable.*       Use av_packet_make_writable instead for that purpose.** @see av_packet_ref* @see av_packet_make_writable** @param pkt packet whose data should be made reference counted.** @return 0 on success, a negative AVERROR on error. On failure, the*         packet is unchanged.*/
int av_packet_make_refcounted(AVPacket *pkt);

该函数作用是：确保给定数据包（pkt指向的对象）描述的数据是引用计数的。

1.如果pkt->buf不为空，表示给定数据包描述的数据已经是引用计数了。该函数返回0，不执行也不需要执行其它操作。

2.如果pkt->buf为空，给pkt->buf和pkt->buf->buffer分配内存，给pkt->buf->data重新分配大小为（pkt->size + AV_INPUT_BUFFER_PADDING_SIZE）个字节内存。然后把pkt->data中的数据拷贝pkt->size个字节到pkt->buf->data中。执行上述操作（情况“2”的操作）后，pkt->buf->buffer->refcount的值会是1，所以可以保证数据已经是引用计数了。

返回值：返回0表示成功，返回一个负数表示失败。

（二）av_packet_make_refcounted函数的定义

av_packet_make_refcounted函数定义在源文件libavcodec/avpacket.c中：

int av_packet_make_refcounted(AVPacket *pkt)
{int ret;if (pkt->buf)return 0;ret = packet_alloc(&pkt->buf, pkt->size);if (ret < 0)return ret;av_assert1(!pkt->size || pkt->data);if (pkt->size)memcpy(pkt->buf->data, pkt->data, pkt->size);pkt->data = pkt->buf->data;return 0;
}

当pkt->buf为空时，av_packet_make_refcounted函数内部会执行packet_alloc函数，而packet_alloc函数内部会执行av_buffer_realloc函数，av_buffer_realloc函数内部又会执行av_buffer_create函数，从《FFmpeg源码：buffer_create、av_buffer_create、av_buffer_default_free、av_buffer_alloc、av_buffer_allocz函数分析》中可以知道，av_buffer_create函数会让refcount的值被初始化为1，所以可以保证数据是引用计数的。