int RTFFormatExFAT(const char *      DriveName, 
                   UINT              SectorsPerCluster, 
                   RTFFormatCallback Progress, 
                   DWORD             Flags);

Parameters

DriveName

Must be a logical drive file name in the form "\\.\X:", where "X" is replaced with the drive letter of the logical drive to be formatted.

SectorsPerCluster

Specifies the desired number of sectors per cluster. This parameter should be 0 to use a default cluster size, or a power of 2 between 1 and 65536.

Progress

A callback to supply progress information:

typedef void (__cdecl * RTFFormatCallback)(const char * DeviceName, 
                                           int          Action, 
                                           DWORD        Total, 
                                           DWORD        Completed);

It will be called periodically by RTFFormatExFAT. Parameter Action can have one of the following values:

Value	Meaning
RTF_FMT_PGS_LOW_FMT	Low-level formatting is in progress.
RTF_FMT_PGS_HIGH_FMT	High-level formatting is in progress.
RTF_FMT_PGS_CLEAR_MEDIUM	The data area of the drive is being deleted.

Total indicates how many sectors must be processed. Completed indicates how many sectors have been processed successfully.

The Progress parameter for RTFFormatExFAT is optional and may be set to NULL.

Flags

Controls various options about how to format the drive. It can be zero or any combination of the following flags:

Value	Meaning
RTF_FMT_FORCE_LOW_LEVEL	This flag forces RTFFormatExFAT to do a low-level format. By default, RTFFormatExFAT will do a low-level format only if writing to the device fails. Hard disks are never low-level formatted by RTFFormatExFAT. If you need to low-level format a hard disk, use the respective raw I/O functions.
RTF_FMT_NO_LOW_LEVEL	Prevent RTFFormatExFAT from low-level formatting a device. If writing to the device fails, the function returns with an error.
RTF_FMT_LARGE_BUFFER	This flag instructs RTFFormatExFAT to temporarily heap-allocate and use a 64k disk buffer instead of its stack-allocated 512 byte buffer. RTF_FMT_LARGE_BUFFER can dramatically improve the speed of formatting and is generally recommended. This flag is mandatory for disks with a sector size larger than 512 bytes.

return value

If the function succeeds, the return value is RTF_NO_ERROR. If it fails, the return value is a negative error code. Demo programs RTFCmd and PartDemo use this function.

RTFFormatExFAT does not perform a surface scan on the volume. Only if writing to any system portion of the drive fails, the function returns the respective error code.

Function RTFFormat

Down Function RTFCheckDisk