FatFs文件系统:f_write
写入数据到一个文件。
FRESULT f_write ( FIL* FileObject, /* 文件对象结构的指针 */ const void* Buffer, /* 存储写入数据的缓冲区的指针 */ UINT ByteToWrite, /* 要写入的字节数 */ UINT* ByteWritten /* 返回已写入字节数变量的指针 */ );
参数:
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 文件对象无效。
描述:
文件对象中的读/写指针以已写入字节数增加。该函数成功后,应该检查 *ByteWritten 来检测磁盘是否已满。在写操作过程中,一旦 *ByteWritten < *ByteToWritten ,则意味着该卷已满。