FFmpeg源码：av_init_packet、get_packet_defaults、av_packet_alloc函数分析

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

AVPacket结构体和其相关的函数分析：

FFmpeg存放压缩后的音视频数据的结构体：AVPacket简介

FFmpeg源码：av_init_packet、get_packet_defaults、av_packet_alloc函数分析

FFmpeg源码：av_packet_free_side_data、av_packet_unref、av_packet_free函数分析

FFmpeg源码：packet_alloc、av_new_packet、av_shrink_packet、av_grow_packet函数分析

FFmpeg源码：av_packet_move_ref、av_packet_make_refcounted函数分析

FFmpeg源码：PacketList结构体、avpriv_packet_list_put、avpriv_packet_list_get、avpriv_packet_list_free函数分析

FFmpeg源码：append_packet_chunked、av_get_packet、av_append_packet函数分析

FFmpeg中调用av_read_frame函数导致的内存泄漏问题

使用vs诊断工具检测FFmpeg的内存泄漏问题

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

一、av_init_packet函数

av_init_packet函数定义在FFmpeg源码（本文演示用的FFmpeg源码版本为7.0.1）的源文件libavcodec/avpacket.c中：

/**
 * Initialize optional fields of a packet with default values.
 *
 * Note, this does not touch the data and size members, which have to be
 * initialized separately.
 *
 * @param pkt packet
 *
 * @see av_packet_alloc
 * @see av_packet_unref
 *
 * @deprecated This function is deprecated. Once it's removed,
               sizeof(AVPacket) will not be a part of the ABI anymore.
 */
void av_init_packet(AVPacket *pkt)
{
    pkt->pts                  = AV_NOPTS_VALUE;
    pkt->dts                  = AV_NOPTS_VALUE;
    pkt->pos                  = -1;
    pkt->duration             = 0;
    pkt->flags                = 0;
    pkt->stream_index         = 0;
    pkt->buf                  = NULL;
    pkt->side_data            = NULL;
    pkt->side_data_elems      = 0;
    pkt->opaque               = NULL;
    pkt->opaque_ref           = NULL;
    pkt->time_base            = av_make_q(0, 1);
}

该函数作用是：初始化一个AVPacket类型变量，给其成员变量赋默认值。注意：在最新版本的FFmpeg源码（比如7.0.1版本中）该函数已被弃用，不推荐继续使用。

形参pkt：输出型参数。指针，指向需要被初始化的AVPacket类型变量。该函数不会对pkt->data和pkt->size进行赋值。

返回值：无。

二、get_packet_defaults函数

新版本的FFmpeg源码使用get_packet_defaults函数来代替av_init_packet函数。get_packet_defaults函数定义在源文件libavcodec/avpacket.c中：

/**
 * @brief Undefined timestamp value
 *
 * Usually reported by demuxer that work on containers that do not provide
 * either pts or dts.
 */
static void get_packet_defaults(AVPacket *pkt)
{
    memset(pkt, 0, sizeof(*pkt));

    pkt->pts             = AV_NOPTS_VALUE;
    pkt->dts             = AV_NOPTS_VALUE;
    pkt->pos             = -1;
    pkt->time_base       = av_make_q(0, 1);
}

该函数作用是：初始化一个已经分配了内存的AVPacket类型变量，给其成员变量pts、dts、pos、time_base赋默认值，让其它成员变量字节清零。注意：执行该函数前必须先给形参pkt指向的AVPacket类型变量分配内存，否则可能会导致程序崩溃。

形参pkt：输出型参数。指针，指向需要被初始化的AVPacket类型变量。执行该函数后：

pkt->pts和pkt->dts的值会变为AV_NOPTS_VALUE，也就是十进制的：-9223372036854775808。

宏AV_NOPTS_VALUE定义在libavutil/avutil.h中，表示时间戳的值未定义：

/**
 * @brief Undefined timestamp value
 *
 * Usually reported by demuxer that work on containers that do not provide
 * either pts or dts.
 */

#define AV_NOPTS_VALUE          ((int64_t)UINT64_C(0x8000000000000000))

pkt->pos的值会变为-1，pkt->time_base->num的值会变为0，pkt->time_base->den的值会变为1。av_make_q函数的用法可以参考：《FFmpeg有理数相关的源码：AVRational结构体和其相关的函数分析》。

返回值：无

三、av_packet_alloc函数

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

/**
 * Allocate an AVPacket and set its fields to default values.  The resulting
 * struct must be freed using av_packet_free().
 *
 * @return An AVPacket filled with default values or NULL on failure.
 *
 * @note this only allocates the AVPacket itself, not the data buffers. Those
 * must be allocated through other means such as av_new_packet.
 *
 * @see av_new_packet
 */
AVPacket *av_packet_alloc(void)
{
    AVPacket *pkt = av_malloc(sizeof(AVPacket));
    if (!pkt)
        return pkt;

    get_packet_defaults(pkt);

    return pkt;
}

该函数作用是：给一个AVPacket类型变量分配内存，并对其成员变量进行初始化。注意：该函数只会给AVPacket本身分配内存，而不会给里面的数据缓冲区（成员变量data和buf指向的缓冲区）分配内存。要想给里面的数据缓冲区分配内存可以使用av_new_packet函数。可以看到该函数内部调用了av_malloc函数来分配内存，关于av_malloc函数用法可以参考：《FFmpeg中内存分配和释放相关的源码：av_malloc函数、av_mallocz函数、av_free函数和av_freep函数分析》。

形参：无

返回值：指针，指向被分配了内存和初始化了的AVPacket类型变量。通过该函数得到的AVPacket类型变量之后必须通过av_packet_free()来释放其空间。