FFmpeg 基本API avio_read函数内部调用流程分析

1、avio_read函数介绍

avio_read 函数是 FFmpeg 中的一个 I/O 函数，它用于从流中读取数据。与 avio_write 类似，avio_read 也通过 AVIOContext 来抽象读操作。avio_read 用于从文件、网络连接或其他数据源中读取字节数据。

int avio_read(AVIOContext *s, unsigned char *buf, int size);

• 参数：
  • s: 一个指向 AVIOContext 的指针，表示输入流的上下文。
  • buf: 一个缓冲区，用来存放从流中读取的数据。
  • size: 要读取的字节数。
• 返回值：
  • 如果成功，返回读取的字节数。
  • 如果到达文件末尾或出错，返回负值。
    • 如果返回值是 0，表示已到达文件末尾（EOF）。
    • 如果返回负值，表示发生了错误。

主要用途：

• 读取音视频数据：avio_read 用于从输入流（如文件或网络流）中读取音视频数据，通常是从文件、流媒体协议（如 RTSP、HTTP）或者网络套接字读取数据。
• 流媒体处理：当接收流媒体数据时，avio_read 会被用来从网络流中获取音视频数据包。

例如：

• 对于文件读取，avio_read 会调用操作系统的文件 I/O 操作。
• 对于网络流读取，avio_read 会使用套接字操作，通过网络协议接收数据。

2、avio_read内部调用流程分析

2.1 参数检查

• 检查 size 是否有效（非负）。
• 验证 AVIOContext 是否包含有效的读回调 (read_packet)。

2.2 缓冲区直接读取

/*如果请求的数据量 小于等于缓冲区可用数据：*/
if (s->buf_end - s->buf_ptr >= size) {
    memcpy(buf, s->buf_ptr, size);  // 直接拷贝数据
    s->buf_ptr += size;             // 移动缓冲区指针
    return size;                    // 返回实际读取大小
}

2.3 大文件直接读取（Direct I/O）

/*
当满足以下条件时，绕过内部缓冲区直接调用用户回调：
请求的 size 大于缓冲区大小。
AVIOContext 启用了 direct 标志。
*/
if (s->direct && size > s->buffer_size) {
    len = s->read_packet(s->opaque, buf, size);  // 直接调用用户回调
    s->pos += len;                               // 更新文件位置
    return len;
}

2.4 缓冲区填充与混合读取

/*
若数据不足，分阶段处理：
步骤1：拷贝缓冲区剩余数据（若有）。
步骤2：循环填充缓冲区并拷贝数据，直到满足请求或遇到错误。
*/
while (size > 0) {// 填充缓冲区（内部调用 read_packet）fill_buffer(s);// 计算本次可拷贝的数据量
    len = FFMIN(s->buf_end - s->buf_ptr, size);
    memcpy(buf, s->buf_ptr, len);// 更新指针和计数器
    buf += len;
    size -= len;
    total_read += len;
 }

3、avio_read调用时序图