Previous

Next

Function DiscardSectors

Driver function DiscardSectors is called by RTFiles-32 whenever a file is deleted or truncated to free any sectors formerly occupied by the file:

int RTFAPI DiscardSectors(void *    DriveData, 
                          RTFSector Sector, 
                          UINT      Sectors);

Parameters

DriveData

Pointer to the DeviceData found in the device list for the device.

Sector

Physical sector index of the first sector to discard.

Sectors

Number of sectors to discard.

return value

If the function succeeds, it returns RTF_NO_ERROR. If it fails, the return value is a negative error code.

This driver function may be used by RAM or flash disks to improve performance. DiscardSectors is optional and may be set to NULL in RTFDriver.

Function MediaChanged

Function GetDiskGeometry