FatFs文件系统:f_write

网站作者2年前FatFs18116

写入数据到一个文件。

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 ,则意味着该卷已满。

相关文章

FatFs文件系统:f_open

创建/打开一个用于访问文件的文件对象。FRESULT f_open (      FIL* FileObject, /* 空白文件对象结构指针 */      const XCHAR* FileN...

FatFs文件系统:f_getfree

获取空闲簇的数目。FRESULT f_getfree (        const XCHAR* Path, /* 驱动器的根目录 */        DWORD* Clusters, /* 存储...

FatFs文件系统:f_printf

f_printf 函数向文件中写入一个格式化字符串。int f_printf (        FIL* FileObject, /* 文件对象指针 */        const char* F...

FatFs文件系统:disk_status

获取当前磁盘的状态DSTATUS disk_status (        BYTE Drive /* 物理驱动器号*/   );参数:Drive 指定待确认的物理驱动器号。 返回值:磁盘状态,是...

FatFs文件系统:f_tell

获取一个文件的当前读/写指针。DWORD f_tell (        FIL* FileObject /* File object */   );参数:FileObject——指向打开文件对象...

FatFs文件系统:disk_ioctl

控制设备特定的功能以及磁盘读写以外的其它功能。DRESULT disk_ioctl (        BYTE Drive, /* 驱动器号 */        BYTE Command, /* ...

发表评论    

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