FatFs文件系统:f_read

网站作者1年前FatFs31840

从一个文件读取数据。

FRESULT f_read ( 
    FIL* FileObject, /* 文件对象结构的指针 */ 
    void* Buffer, /* 存储读取数据的缓冲区的指针 */ 
    UINT ByteToRead, /* 要读取的字节数 */ 
    UINT* ByteRead /* 返回已读取字节数变量的指针 */
);


参数:

FileObject 指向将被读取的已打开的文件对象结构的指针。

Buffer 指向存储读取数据的缓冲区的指针。

ByteToRead 要读取的字节数,UINT 范围内。

ByteRead 指向返回已读取字节数的 UINT 变量的指针。在调用该函数后,无论结果如何,数值都是有效的。


返回值:

FR_OK (0)函数成功。

FR_DENIED 由于文件是以非读模式打开的,而导致该函数被拒绝。

FR_DISK_ERR 由于底层磁盘 I/O 函数中的错误,而导致该函数失败。

FR_INT_ERR 由于一个错误的 FAT 结构或一个内部错误,而导致该函数失败。

FR_NOT_READY 由于驱动器中没有存储介质或任何其他原因,而导致磁盘驱动器无法工作。

FR_INVALID_OBJECT 文件对象无效。


描述:

文件对象中的读/写指针以已读取字节数增加。该函数成功后,应该检查 *ByteRead 来检测文件是否结束。在读操作过程中,一旦 *ByteRead < ByteToRead ,则读/写指针到达了文件结束位置。

相关文章

FatFs文件系统:f_chdrive

f_chdrive 函数改变当前驱动器。FRESULT f_chdrive (        BYTE Drive /* 逻辑驱动器号 */   );参数:Drive 指定将被设置为当前驱动器的逻...

FatFs文件系统:f_puts

f_puts 函数向文件中写入一个字符串。int f_puts (        const char* Str, /* 字符串指针 */        FIL* FileObject /* 文件...

FatFs文件系统:f_lseek

移动一个打开的文件对象的文件读/写指针。也可以被用来扩展文件大小(簇预分配)。FRESULT f_lseek (      FIL* FileObject, /* 文件对象结构指针 */     ...

FatFs文件系统:f_sync

冲洗一个写文件的缓存信息。FRESULT f_sync (      FIL* FileObject /* 文件对象结构的指针 */ );参数:FileObject 待冲洗的打开的文件对象的指针。...

FatFs文件系统:f_rename

重命名一个对象。FRESULT f_rename (        const XCHAR* OldName, /* 原对象名的指针 */        const XCHAR* NewName ...

FatFs文件系统:f_error

测试文件是否出错。int f_error (        FIL* FileObject /* File object */   );参数:FileObject——指向打开文件对象结构的指针。 ...

发表评论    

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。