fs_setvbuf()
int fs_setvbuf (FS_FILE *p_file,
char *p_buf,
int mode,
fs_size_t size);
|
File |
Called from |
Code enabled by |
|
fs_api.c |
Application |
FS_CFG_API_EN and FS_CFG_FILE_BUF_EN |
Assign buffer to a file.
Arguments
p_file
Pointer to a file.
p_buf
Pointer to buffer.
mode
Buffer mode:
Returned Value
-1, if an error occurs.
0, if no error occurs.
Notes/Warnings
fs_setvbuf() must be used after a stream is opened but before any other operation is performed on stream.
size must be more than or equal to the size of one sector; it will be rounded DOWN to the nearest size of a multiple of full sectors.
Once a buffer is assigned to a file, a new buffer may not be assigned nor may the assigned buffer be removed. To change the buffer, the file should be closed and re-opened.
Upon power loss, any data stored in file buffers will be lost.