FILEget_next_cluster Function

Microchip MDD File System Interface

MDDFS Interface Library Help

BYTE FILEget_next_cluster(
    FILEOBJ fo, 
    DWORD n
);

Description

This function will load 'n' proximate clusters for a file from the FAT on the device. It will stop checking for clusters if the ReadFAT function returns an error, if it reaches the last cluster in a file, or if the device tries to read beyond the last cluster used by the device.

Preconditions

This function should not be called by the user.

Parameters

Parameters	Description
fo	The file to get the next cluster of
n	Number of links in the FAT cluster chain to jump through

Return Values

Return Values	Description
CE_GOOD	Operation successful
CE_BAD_SECTOR_READ	A bad read occured of a sector
CE_INVALID_CLUSTER	Invalid cluster value > maxcls
CE_FAT_EOF	Fat attempt to read beyond EOF

Side Effects

None

Remarks

None

APIs > File Manipulation Layer (FSIO) > Internal Members > FILEget_next_cluster Function

Contents | Index | Home

previous page start next page