Location:
f32file.h
Link against: efsrv.lib
class RFormat : public RSubSessionBase;
Formats a device, one step at a time.
RFormat must first be opened on a device before formatting each track using Next()
.
There is also an asynchronous version of Next()
which, if encapsulated into a suitable active object, can be used to implement a user-interruptible formatting process.
RSubSessionBase
- Client-side handle to a sub-session
RFormat
- Formats a device, one step at a time
Defined in RFormat
:
Close()
, Next()
, Next()
, Open()
, Open()
Inherited from RSubSessionBase
:
CloseSubSession()
,
CreateAutoCloseSubSession()
,
CreateSubSession()
,
Send()
,
SendReceive()
,
Session()
,
SubSessionHandle()
Capability: | DiskAdmin |
IMPORT_C TInt Open(RFs &aFs, const TDesC &aName, TUint aFormatMode, TInt &aCount);
Opens a device for formatting.
The device may be formatted either at high or low density.
Devices which support read-only media may not be formatted. This includes the ROM on drive Z:. All files on the drive must be closed otherwise an error is returned.
|
|
Capability: | DiskAdmin |
IMPORT_C TInt Open(RFs &aFs, const TDesC &aName, TUint aFormatMode, TInt &aCount, const TDesC8 &anInfo);
Opens a device for formatting. User
can specify new format parameters by anInfo.
The device may be formatted either at high or low density.
Devices which support read-only media may not be formatted. This includes the ROM on drive Z:. All files on the drive must be closed otherwise an error is returned.
|
|
IMPORT_C void Close();
Closes the Format subsession.
Any open files are closed when the file server session is closed.
Close()
is guaranteed to return, and provides no indication whether it completed successfully or not.
Capability: | DiskAdmin |
IMPORT_C TInt Next(TInt &aStep);
Executes the next format step.
This is a synchronous function, which returns when the formatting step is complete.
|
|
Capability: | DiskAdmin |
IMPORT_C void Next(TPckgBuf< TInt > &aStep, TRequestStatus &aStatus);
Executes the next format step.
This is an asynchronous function.
|