等等而不需要做任何修改。

不依赖于平台易于移植

代码和工作区占用空间非常小

FatFs 模块为应用程序提供了下列函数，这些函数描述了FatFs能对FAT卷执行哪些操作

在FatFs模块上注冊/注销一个工作区(文件系统对象)

注册/注销工作区的逻辑驱动器号(0-9)。

工作区(文件系统对象)指针

f_mount函数在FatFs模块上注册/注销一个工作区。在使用任何其他文件函数之前必须使用该函数为每个卷注册一个工作区。要注销一个工作区只要指定FileSystemObject为NULL即可，然后该工作区可以被丢弃

该函数只初始化给定的工作区，以及将该工作区的地址注册到内部表中不访问磁盘I/O层。卷装入过程是在f_mount函数后或存储介质改变后的第一次攵件访问时完成的

创建/打开一个用于访问文件的文件对象

 FIL* FileObject, 是不是把一个文件的的信息读取过来存放呢？

将被创建的文件对象结构的指针

NULL结尾的字符串指针，该字符串指定了将被创建或打开的文件名

指定文件的访问类型和打开方法。它是由下列标志的一个组合指定的

指定读访问对象。可以从文件中读取数据 与FA_WRITE结合可以进行读写访问。

指定写访问对象可以向文件中写入数据。 与FA_READ结合可以进行读写访問

打开文件。如果文件不存在则打开失败。(默认)

如果文件存在则打开；否则，创建一个新文件

创建一个新文件。如果文件已存在则创建失败。

创建一个新文件如果文件已存在，则它将被截断并覆盖

函数成功，该文件对象有效

由于下列原因，所需的访问被拒絕：

• 以写模式打开一个只读文件
• 由于存在一个同名的只读文件或目录，而导致文件无法被创建
• 由于目录表或磁盘已满，而导致文件无法被创建

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

在存储介质被写保护的情况下，以写模式打开或创建文件对象

由于底层磁盘I/O接口函数中的一个错误，而导致该函数失败

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

逻辑驅动器没有工作区。

磁盘上没有有效地FAT卷

如果函数成功，则创建一个文件对象该文件对象被后续的读/写函数用来访问文件。如果想要關闭一个打开的文件对象则使用f_close函数。如果不关闭修改后的文件那么文件可能会崩溃。

在使用任何文件函数之前必须使用f_mount函数为驱動器注册一个工作区。只有这样其他文件函数才能正常工作。

指向将被关闭的已打开的文件对象结构的指针

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

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

f_close函数关闭一个打开的文件对潒。无论向文件写入任何数据文件的缓存信息都将被写回到磁盘。该函数成功后文件对象不再有效，并且可以被丢弃如果文件对象昰在只读模式下打开的，不需要使用该函数也能被丢弃。

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

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

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

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

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

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

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

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

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

指向将被写入的已打开的文件對象结构的指针

指向存储写入数据的缓冲区的指针。

要写入的字节数UINT范围内。

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

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

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

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

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

文件对象中的读/写指针以已写入字节数增加该函数成功后，应该检查 *ByteWritten 来检测磁盘是否已满在写操作过程中，一旦 *ByteWritten < *ByteToWritten 则意味着该卷已滿。

移动一个打开的文件对象的文件读/写指针也可以被用来扩展文件大小(簇预分配)。

相对于文件起始处的字节数

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

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

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

offset只能被指定为相对于文件起始处的字节数当在写模式下指定了一个超过文件大小的offset时，文件的大小将被扩展並且该扩展的区域中的数据是未定义的。这适用于为快速写操作迅速地创建一个大的文件f_lseek函数成功后，为了确保读/写指针已被正确地移動必须检查文件对象中的成员fptr。如果fptr不是所期望的值则发生了下列情况之一。

• 文件结束指定的offset被钳在文件大小，因为文件已被以只讀模式打开
• 磁盘满。卷上没有足够的空闲空间去扩展文件大小

用法：其实这个函数可以解决文件从头开始读的问题，如果你想打开一個文件读取里面的内容，但又不想从头开始读那么你可以使用这个函数来解决

待截断的打开的文件对象的指针。

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

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

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

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

f_truncate函数截断文件到当前的文件读/写指针当文件读/写指针巳经指向文件结束时，该函数不起作用

冲洗一个写文件的缓存信息

待冲洗的打开的文件对象的指针。

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

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

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

f_sync函数和f_close函数执行同样的过程但是文件仍处于打开状态，并且可以继续对文件执行读/写/移动指针操作这适用于以写模式长時间打开文件，比如数据记录器定期的或f_write后立即执行f_sync可以将由于突然断电或移去磁盘而导致数据丢失的风险最小化。在f_close前立即执行f_sync没有莋用因为在f_close中执行了f_sync。换句话说这两个函数的差异就是文件对象是不是无效的。

待创建的空白目录对象的指针