ffmpeg之av_dump_format函数详细解释

av_dump_format函数是FFmpeg库提供的用于将AVFormatContext结构体中媒体文件的信息进行格式化输出的函数。该函数定义在libavformat/avformat.h头文件中。
函数原型如下：

void av_dump_format(AVFormatContext *ic, int index, const char *url, int is_output);

函数参数含义：

ic：AVFormatContext结构体指针，表示媒体文件的格式上下文。
index：指定输出音视频流的索引号，当index为-1时代表输出所有音视频流的信息。
url：指定媒体文件的URL，通常设置为NULL。
is_output：指定是否是输出上下文，1表示输出AVOutputContext格式信息，0表示输出AVInputContext格式信息。

该函数的作用是输出媒体文件的格式信息，包括文件格式、码率、格式特征信息、音视频流等相关信息，以便于用户了解媒体文件的详细信息。
下面是一个简单的代码示例，演示如何使用avdumpformat函数打印媒体文件的信息：

#include <libavformat/avformat.h>

int main(int argc, char *argv[]) {
    
    
    AVFormatContext *fmt_ctx = NULL;

    int ret = avformat_open_input(&fmt_ctx, "example.mp4", NULL, NULL);
    if (ret < 0) {
    
    
        av_log(NULL, AV_LOG_ERROR, "Cannot open input file\n");
        return -1;
    }

    ret = avformat_find_stream_info(fmt_ctx, NULL);
    if (ret < 0) {
    
    
        av_log(NULL, AV_LOG_ERROR, "Cannot find stream information\n");
        avformat_close_input(&fmt_ctx);
        return -1;
    }

    // 输出文件信息
    av_dump_format(fmt_ctx, 0, "example.mp4", 0);

    avformat_close_input(&fmt_ctx);

    return 0;
}

在上面的示例代码中，我们首先打开一个MP4格式的文件，并检查是否成功打开了文件。然后我们调用avformatfindstream_info来获取该媒体文件中每个音视频流的详细信息。如果获取信息失败，程序将打印出错误信息，并在关闭文件之前释放AVFormatContext结构体的空间。
最后，我们调用avdumpformat函数将获取到的媒体流信息格式化输出到标准输出中，以便观察和调试。