Description
FatFs ต้องการ work area (filesystem object) สำหรับแต่ละ logical drives (FAT volumes). ก่อนดำเนินการ any file/directory operations, a filesystem object จำเป็นต้องถูก registered ด้วย f_mount function สำหรับ the logical drive. The file/directory API functions พร้อมที่จะทำงานหลังจากขบวนการนี้. Some volume management functions, f_mkfs, f_fdisk and f_setcp, ไม่ต้องการ a filesystem object.

The f_mount function รีจีสเตอร์/ยกเลิกการรีจีสเตอร์ a filesystem object ให้กับ the FatFs module ดังต่อไปนี้:

1. กำหนด the logical drive ซึ่งถูกระบุโดย path.
2. เคลียร์และยกเลิกการรีจีสเตอร์ the regsitered work area of the volume ถ้ามีอยู่.
3. เคลียร์และรีจีสเตอร์ the new work area ให้กับ the volume ถ้า fs ไม่เป็น NULL.
4. ดำเนินการ volume mount process ให้กับ the volume ถ้า forced mounting ถูกระบุ.

http://elm-chan.org/fsw/ff/doc/getcwd.html



Parameters
   buff
       ตัวชี้ไปยัง the buffer ที่รับ the current directory string.
   len
       ขนาดของ the buffer ในหน่วยของ TCHAR.

Return Values
FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_NOT_ENABLED, FR_NO_FILESYSTEM, FR_TIMEOUT, FR_NOT_ENOUGH_CORE

Description
The f_getcwd function ดึง full path name ของ the current directory ของ the current drive. เมื่อ FF_VOLUMES >= 2, a heading drive prefix ถูกเพิ่มไปยัง the path name. The style of drive prefix ขึ้นอยู่กับ FF_STR_VOLUME_ID.
Note: ใน revision นี้, function นี้ไม่สามารถดึง the current directory path บน the exFAT volume. มันส่งคืนกลับ the root directory path เสมอ.

QuickInfo
Available when FF_FS_RPATH == 2.

Example


See Also
f_chdrive, f_chdir

http://elm-chan.org/fsw/ff/doc/chdir.html



Parameters
   path
       ตัวชี้ไปยัง the null-terminated string ที่ระบุ the directory ที่จะถูกเซ็ตเป็น current directory.

Return Values
FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_NO_PATH, FR_INVALID_NAME, FR_INVALID_DRIVE, FR_NOT_ENABLED, FR_NO_FILESYSTEM, FR_TIMEOUT, FR_NOT_ENOUGH_CORE

Description
The f_chdir function เปลี่ยน the current directory of the logical drive. นอกจากนี้ the current drive จะถูกเปลี่ยนเมื่ออยู่ใน Unix style drive prefix, FF_STR_VOLUME_ID == 2. The current directory ของแต่ละ logical drive ถูกเตรียมข้อมูลเบื้องต้นให้กับ the root directory บน(ตอน) mount.
โปรดทราบว่า the current directory ถูกรักษาไว้ใน the each file system object และ the current drive ถูกรักษาไว้ใน a static variable, ดังนั้นมันยังมีผลต่องานอื่นๆที่ใช้ the file functions ด้วย.

QuickInfo
มีให้ใช้งานเมื่อ FF_FS_RPATH >= 1.

Example


See Also
f_chdrive, f_getcwd

http://elm-chan.org/fsw/ff/doc/utime.html



Parameters
   path
       ตัวชี้ไปยัง the null-terminated string ที่ระบุ an object ที่จะถูกเปลี่ยน
   fno
      ตัวชี้ไปยัง the file information structure ที่มี a timestamp ที่จะถูกเซ็ตใน member fdate and ftime. ไม่สนใจ members
      อื่นใดๆ.

Return Values
FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_NO_FILE, FR_NO_PATH, FR_INVALID_NAME, FR_WRITE_PROTECTED, FR_INVALID_DRIVE, FR_NOT_ENABLED, FR_NO_FILESYSTEM, FR_TIMEOUT, FR_NOT_ENOUGH_CORE

Description
The f_utime function เปลี่ยน the timestamp of a file or sub-directory

Example


QuickInfo
มีให้ใช้งานเมื่อ FF_FS_READONLY == 0 and FF_USE_CHMOD == 1.

See Also
f_stat, FILINFO

http://elm-chan.org/fsw/ff/doc/rename.html



Parameters
   old_name
       ตัวชี้ไปยัง a null-terminated string ที่ระบุ the existing file or sub-directory ที่จะถูกเปลี่ยนชื่อ.
   new_name
       ตัวชี้ไปยัง a null-terminated string ที่ระบุ the new object name. A drive number อาจถูกระบุใน string นี้แต่มันจะถูกเพิก
       เฉยและทึกทักเอาว่าเป็น the same drive ของ the old_name. object ใดๆที่มี path name นี้ยกเว้น old_name จะต้องไม่มีอยู่,
       มิฉะนั้น the function จะล้มเหลวด้วย FR_EXIST.

Return Values
FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_NO_FILE, FR_NO_PATH, FR_INVALID_NAME, FR_EXIST, FR_WRITE_PROTECTED, FR_INVALID_DRIVE, FR_NOT_ENABLED, FR_NO_FILESYSTEM, FR_TIMEOUT, FR_LOCKED, FR_NOT_ENOUGH_CORE

Description
เปลี่ยนชื่อ a file or sub-directory และสามารถย้ายมันไปยัง directory อื่นใน the same volume ได้อีกด้วย. The object ที่จะถูกเปลี่ยนชื่อต้องไม่เป็น an open object, มิฉะนั้น the FAT volume สามารถถูกยุบได้. the wrong operation ดังกล่าวจะถูกปฏิเสธอย่างปลอดภัยเมื่อ file lock function ถูกเปิดใช้งาน.

QuickInfo
มีให้ใช้งานเมื่อ FF_FS_READONLY == 0 and FF_FS_MINIMIZE == 0.

Example