ff_fread()

[FreeRTOS-Plus-FAT 标准 API 引用]

ff_stdio.h

size_t ff_fread( void *pvBuffer, size_t xSize, size_t xItems, FF_FILE * pxStream );

从嵌入式 FAT 文件系统中的打开文件的当前读取/写入位置读取数据。读取/写入位置按读取的字节数递增。

参数：

pvBuffer	指向放置读取自文件的数据的缓冲区的指针。缓冲区大小至少要足够容纳正在读取的字节数。
xSize	从文件读取的每个项目的大小（以字节为单位）。
xItems	要从文件读取的项目数。每个项目的大小大小由 xSize 参数设置。
pxStream	指向数据待读取的文件的指针。该指针与调用 ff_fopen() 返回的指针相同，最初用于打开文件。

返回：

返回实际从文件读取的项目数。当项目大小为 1 时，从文件读取的项目数只能等于从文件读取的项目数。每个项目的大小由 xSize 参数设置。

如果从文件读取的项目数小于 xItems 值，则任务的 errno 将设置为指示原因。任务可以使用 stdioGET_ERRNO() API 函数获取其 errno 值。

用法示例：

ff_fopen() 文档页面中提供的示例显示了 ff_fread() 的使用方式。