GEOS SDK TechDocs
|
| 
2 Modifying Files on the FFS
| 
4 Utility Space Routines
FoamWarnIfNotEnoughSpace(), FoamCheckIfOutOfSpace(), FoamDiskSpaceStatus
Some operations may consume memory once they are begun, and it might be difficult to stop them once they start. For example, receiving a fax, reading or receiving e-mail, downloading something from the Web or printing a document may all consume FFS space.
FoamWarnIfNotEnoughSpace()
takes a numeric value corresponding to the bytes required for the operation. If the operation would result in memory falling below the critical level, the routine will notify the user that it has insufficient memory to complete the operation (via a dialog box) and will return FDDS_FULL.
If the operation can proceed otherwise, it will return the appropriate
FoamDiskSpaceStatus
value:
FoamCheckIfOutOfSpace()
also returns a
FoamDiskSpaceStatus
but does not initiate any dialog box.
You should call
FoamWarnSpaceAfter Operation()
after any operation that consumes FFS space. If the operation resulted in an FDDS_NEARLY_FULL status, the routine brings up a dialog alerting the user that the device is nearly out of FFS space.
GEOS SDK TechDocs
|
| 2 Modifying Files on the FFS
| 4 Utility Space Routines