f_getfree

The f_getfree gets number of the free clusters.

FRESULT f_getfree (
  DWORD* Clusters     // Pointer to the variable to store number of free clusters.
);

Parameters

Clusters

Pointer to the DWORD variable to store number of free clusters.

Return Values

FR_OK

The function succeeded. The *Clusters havs number of free clusters.

FR_NOT_READY

The disk drive cannot work due to no medium in the drive or any other reason.

FR_RW_ERROR

Any error occured in low level disk I/O.

FR_INCORRECT_DISK_CHANGE

Incorrect disk removal, such as a medium change during any file is opend, has been occured.

FR_NOT_ENABLED

FatFs module has not been enabled.

FR_NO_FILESYSTEM

There is no valid FAT partition on the disk.

Descriptions

The f_getfree gets number of free clusters on the drive. The FatFs.sects_clust is indicating number of sectors per cluster, so that the free space in unit of byte can be calcurated with this.

Samples Code

    DWORD clust;

    // Get free clusters
    res = f_getfree(&clust);
    if (res) die(res);

    // Get free bytes
    printf("%lu bytes available on the disk.\n", clust * FatFs->sects_clust * 512);

References

FATFS