參考鏈接

• FFmpeg源代碼簡單分析：avformat_close_input()_雷霄驊的博客-CSDN博客_avformat_close_input

avformat_close_input()

• 本文簡單分析FFmpeg的avformat_close_input()函數。
• 該函數用于關閉一個AVFormatContext，一般情況下是和avformat_open_input()成對使用的。
• avformat_close_input()的聲明位于libavformat\avformat.h，如下所示。

/*** Close an opened input AVFormatContext. Free it and all its contents* and set *s to NULL.*/
void avformat_close_input(AVFormatContext **s);

• 下面看一下avformat_close_input()的源代碼，位于demux.c文件中。?

void avformat_close_input(AVFormatContext **ps)
{AVFormatContext *s;AVIOContext *pb;if (!ps || !*ps)return;s  = *ps;pb = s->pb;if ((s->iformat && strcmp(s->iformat->name, "image2") && s->iformat->flags & AVFMT_NOFILE) ||(s->flags & AVFMT_FLAG_CUSTOM_IO))pb = NULL;if (s->iformat)if (s->iformat->read_close)s->iformat->read_close(s);avformat_free_context(s);*ps = NULL;avio_close(pb);
}

函數調用關系圖

• 函數的調用關系如下圖所示

• ?從源代碼中可以看出，avformat_close_input()主要做了以下幾步工作：
  • （1）調用AVInputFormat的read_close()方法關閉輸入流
  • （2）調用avformat_free_context()釋放AVFormatContext
  • （3）調用avio_close()關閉并且釋放AVIOContext

AVInputFormat-> read_close()

• AVInputFormat的read_close()是一個函數指針，指向關閉輸入流的函數。
• 不同的AVInputFormat包含有不同的read_close()方法。
• 例如，FLV格式對應的AVInputFormat的定義如下。

const AVInputFormat ff_flv_demuxer = {.name           = "flv",.long_name      = NULL_IF_CONFIG_SMALL("FLV (Flash Video)"),.priv_data_size = sizeof(FLVContext),.read_probe     = flv_probe,.read_header    = flv_read_header,.read_packet    = flv_read_packet,.read_seek      = flv_read_seek,.read_close     = flv_read_close,.extensions     = "flv",.priv_class     = &flv_kux_class,
};

• 從ff_flv_demuxer的定義中可以看出，read_close()指向的函數是flv_read_close()
• 我們可以看一下flv_read_close()的定義，如下所示。
• 從flv_read_close()的定義可以看出，該函數釋放了FLVContext中的new_extradata數組中每個元素指向的內存。

static int flv_read_close(AVFormatContext *s)
{int i;FLVContext *flv = s->priv_data;for (i=0; i<FLV_STREAM_TYPE_NB; i++)av_freep(&flv->new_extradata[i]);av_freep(&flv->keyframe_times);av_freep(&flv->keyframe_filepositions);return 0;
}

avformat_free_context()

• avformat_free_context()是一個FFmpeg的API函數，用于釋放一個AVFormatContext。
• 在這里要注意搞清楚avformat_free_context()和avformat_close_input()之間的區別與聯系。
• 有關avformat_free_context()可以參考文章：FFmpeg源代碼簡單分析-通用-常見結構體的初始化和銷毀（AVFormatContext，AVFrame等）_MY CUP OF TEA的博客-CSDN博客

avio_close()

• avio_close()是一個FFmpeg的API函數，用于關閉和釋放AVIOContext。
• 它的聲明位于libavformat\avio.h，如下所示

/*** Close the resource accessed by the AVIOContext s and free it.* This function can only be used if s was opened by avio_open().** The internal buffer is automatically flushed before closing the* resource.** @return 0 on success, an AVERROR < 0 on error.* @see avio_closep*/
int avio_close(AVIOContext *s);

int avio_close(AVIOContext *s)
{FFIOContext *const ctx = ffiocontext(s);URLContext *h;int ret, error;if (!s)return 0;avio_flush(s);h         = s->opaque;s->opaque = NULL;av_freep(&s->buffer);if (s->write_flag)av_log(s, AV_LOG_VERBOSE,"Statistics: %"PRId64" bytes written, %d seeks, %d writeouts\n",ctx->bytes_written, ctx->seek_count, ctx->writeout_count);elseav_log(s, AV_LOG_VERBOSE, "Statistics: %"PRId64" bytes read, %d seeks\n",ctx->bytes_read, ctx->seek_count);av_opt_free(s);error = s->error;avio_context_free(&s);ret = ffurl_close(h);if (ret < 0)return ret;return error;
}

• 從源代碼可以看出，avio_close()按照順序做了以下幾個步驟：
  • （1）調用avio_flush()強制清除緩存中的數據
  • （2）調用av_freep()釋放掉AVIOContext種的buffer
  • （3）調用av_free()釋放掉AVIOContext結構體? av_free函數棄用，av_opt_free和avio_context_free
  • （4）調用ffurl_close()關閉并且釋放掉URLContext
• 下面按照順序分別看看avio_flush()和ffurl_close()這兩個函數

avio_flush()

• avio_flush()是一個FFmpeg的API函數，聲明位于libavformat\avio.h，如下所示。

void avio_flush(AVIOContext *s)
{int seekback = s->write_flag ? FFMIN(0, s->buf_ptr - s->buf_ptr_max) : 0;flush_buffer(s);if (seekback)avio_seek(s, seekback, SEEK_CUR);
}

• 可以看出avio_flush()簡單調用了flush_buffer()函數。我們看一下flush_buffer()的定義。

static void flush_buffer(AVIOContext *s)
{s->buf_ptr_max = FFMAX(s->buf_ptr, s->buf_ptr_max);if (s->write_flag && s->buf_ptr_max > s->buffer) {writeout(s, s->buffer, s->buf_ptr_max - s->buffer);if (s->update_checksum) {s->checksum     = s->update_checksum(s->checksum, s->checksum_ptr,s->buf_ptr_max - s->checksum_ptr);s->checksum_ptr = s->buffer;}}s->buf_ptr = s->buf_ptr_max = s->buffer;if (!s->write_flag)s->buf_end = s->buffer;
}

• 從flush_buffer()定義我們可以看出，該函數將當前緩存指針buf_ptr的位置重新設置到緩存buffer的首部，然后根據AVIOContext對應的流是否可寫分別做不同的處理。
• 如果AVIOContext對應的流是只讀的（write_flag取值為0），就將緩存的尾部buf_end設定到緩存首部位置；
• 如果AVIOContext對應的流如果是可寫的（write_flag取值非0），則會調用writeout()函數輸出緩存中剩余的數據。
• 在這里我們看一下writeout()函數的定義，如下所示。

static void writeout(AVIOContext *s, const uint8_t *data, int len)
{FFIOContext *const ctx = ffiocontext(s);if (!s->error) {int ret = 0;if (s->write_data_type)ret = s->write_data_type(s->opaque, (uint8_t *)data,len,ctx->current_type,ctx->last_time);else if (s->write_packet)ret = s->write_packet(s->opaque, (uint8_t *)data, len);if (ret < 0) {s->error = ret;} else {ctx->bytes_written += len;s->bytes_written = ctx->bytes_written;if (s->pos + len > ctx->written_output_size) {ctx->written_output_size = s->pos + len;
#if FF_API_AVIOCONTEXT_WRITTEN
FF_DISABLE_DEPRECATION_WARNINGSs->written = ctx->written_output_size;
FF_ENABLE_DEPRECATION_WARNINGS
#endif}}}if (ctx->current_type == AVIO_DATA_MARKER_SYNC_POINT ||ctx->current_type == AVIO_DATA_MARKER_BOUNDARY_POINT) {ctx->current_type = AVIO_DATA_MARKER_UNKNOWN;}ctx->last_time = AV_NOPTS_VALUE;ctx->writeout_count++;s->pos += len;
}

• 從定義可以看出，writeout()調用了AVIOContext的write_packet()方法。根據此前文章《FFmpeg源代碼簡單分析：avio_open2()》中的分析我們可以了解到，AVIOContext的write_packet()實際指向了ffurl_write()函數，而ffurl_write()經過retry_transfer_wrapper()函數最終調用了URLProtocol的url_write()函數。url_write()是一個函數指針，不同的URLProtocol的url_write()指向不同的函數。
• 例如，file（文件）對應的URLProtocol的定義位于libavformat\file.c，如下所示。

const URLProtocol ff_file_protocol = {.name                = "file",.url_open            = file_open,.url_read            = file_read,.url_write           = file_write,.url_seek            = file_seek,.url_close           = file_close,.url_get_file_handle = file_get_handle,.url_check           = file_check,.url_delete          = file_delete,.url_move            = file_move,.priv_data_size      = sizeof(FileContext),.priv_data_class     = &file_class,.url_open_dir        = file_open_dir,.url_read_dir        = file_read_dir,.url_close_dir       = file_close_dir,.default_whitelist   = "file,crypto,data"
};

• 可以看出ff_file_protocol中的url_write()指向的是file_write()函數。
• 我們繼續看一下file_write()的源代碼，如下所示。
• 從源代碼中可以看出file_write()調用了系統的write()方法向文件中寫數據（很多人可能對write()函數很陌生，可以簡單理解為它等同于fwrite()）。

static int file_write(URLContext *h, const unsigned char *buf, int size)
{FileContext *c = h->priv_data;int ret;size = FFMIN(size, c->blocksize);ret = write(c->fd, buf, size);return (ret == -1) ? AVERROR(errno) : ret;
}

ffurl_close()和ffurl_closep()

• ffurl_close()和ffurl_closep()是FFmpeg內部的兩個函數，它們的聲明位于libavformat\url.h，如下所示。
• 其實這兩個函數是等同的

/*** Close the resource accessed by the URLContext h, and free the* memory used by it. Also set the URLContext pointer to NULL.** @return a negative value if an error condition occurred, 0* otherwise*/
int ffurl_closep(URLContext **h);
int ffurl_close(URLContext *h);

• 可見ffurl_close()調用了ffurl_closep()。

int ffurl_close(URLContext *h)
{return ffurl_closep(&h);
}

• ffurl_closep()的定義如下所示。

int ffurl_closep(URLContext **hh)
{URLContext *h= *hh;int ret = 0;if (!h)return 0;     /* can happen when ffurl_open fails */if (h->is_connected && h->prot->url_close)ret = h->prot->url_close(h);
#if CONFIG_NETWORKif (h->prot->flags & URL_PROTOCOL_FLAG_NETWORK)ff_network_close();
#endifif (h->prot->priv_data_size) {if (h->prot->priv_data_class)av_opt_free(h->priv_data);av_freep(&h->priv_data);}av_opt_free(h);av_freep(hh);return ret;
}

• 從ffurl_closep()的定義可以看出，它主要做了兩步工作：
  • （1）調用URLProtocol的url_close()
  • （2）調用av_freep()釋放URLContext結構體
• 其中URLProtocol的url_close()是一個函數指針，其指向的函數與具體的URLProtocol有關，這里我們還是看一下file（文件）對應的URLProtocol，如下所示。

const URLProtocol ff_file_protocol = {.name                = "file",.url_open            = file_open,.url_read            = file_read,.url_write           = file_write,.url_seek            = file_seek,.url_close           = file_close,.url_get_file_handle = file_get_handle,.url_check           = file_check,.url_delete          = file_delete,.url_move            = file_move,.priv_data_size      = sizeof(FileContext),.priv_data_class     = &file_class,.url_open_dir        = file_open_dir,.url_read_dir        = file_read_dir,.url_close_dir       = file_close_dir,.default_whitelist   = "file,crypto,data"
};

• 從ff_file_protocol中可以看出，url_close()指向file_close()函數。我們再看一下file_close()的定義，如下所示。、

static int file_close(URLContext *h)
{FileContext *c = h->priv_data;int ret = close(c->fd);return (ret == -1) ? AVERROR(errno) : 0;
}

• 可見file_close()最終調用了系統函數close()關閉了文件指針（不熟悉close()的可以簡單把它理解為fclose()）。
• 至此avio_close()函數分析完畢。