第 4 页 共 22 页
/* 注销工作区(在废弃前) */
f_mount(0, NULL);
f_mount(1, NULL);
}
3. f_close 函数
3.1 功能
关闭一个打开的文件
3.2 原型
FRESULT f_close (
FIL* FileObject /* 文件对象结构的指针 */
);
3.3 参数
FileObject 指向将被关闭的已打开的文件对象结构的指针。
返回值
FR_OK (0)文件对象已被成功关闭。>FR_DISK_ERR 由于底层磁盘 I/O 函数中的错误,而导致该函数失败。FR_INT_ERR 由于一个
错误的 FAT 结构或一个内部错误,而导致该函数失败。
FR_NOT_READY 由于驱动器中没有存储介质或任何其他原因,而导致磁盘驱动器无法工作。
FR_INVALID_OBJECT 文件对象无效。
3.4 详细描述
f_close 函数关闭一个打开的文件对象。无论向文件写入任何数据,文件的缓存信息都将被写回到磁盘。该函数成功后,
文件对象不再有效,并且可以被丢弃。如果文件对象是在只读模式下打开的,不需要使用该函数,也能被丢弃。
4. f_read 函数
4.1 功能
从一个文件读取数据
4.2 原型
FRESULT f_read (
FIL* FileObject, /* 文件对象结构的指针 */
void* Buffer, /* 存储读取数据的缓冲区的指针 */
UINT ByteToRead, /* 要读取的字节数 */
UINT* ByteRead /* 返回已读取字节数变量的指针 */
);
4.3 参数
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 文件对象无效。