Previous

Next

Function LowLevelFormat

Driver function LowLevelFormat is called when a device must be low-level formatted:

int RTFAPI LowLevelFormat(void            * DriveData, 
                          const char      * DeviceName, 
                          RTFFormatCallback Progress, 
                          DWORD             Flags);

Parameters

DriveData

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

DeviceName

Pointer to a name of the drive to be passed to Progress.

Progress

Pointer to a callback function. Please see function RTFFormat for details.

Flags

Options for the format process. Please see function RTFFormat for details.

return value

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

Low-level formatting should bring the volume into a state that allows sector-level reading and writing. Devices which do not require any low-level formatting should return RTF_NO_ERROR. If low-level formatting is required by a device type, but the driver does not support it, RTF_UNSUPPORTED_DRIVER_FUNCTION should be returned. This function is optional and may be set to NULL in RTFDriver. Even if it is NULL, RTFiles-32 can still high-level format devices handled by the driver.

Function GetDiskGeometry

Function IoControl