VFGetDriveFreeSize(W)

Syntax


#include <revolution/vf.h>

typedef u16	VFWchar;

s32 VFGetDriveFreeSize( const char* drive );
s32 VFGetDriveFreeSizeW( const VFWchar* drive );

Arguments

path The name of the drive to be mounted. Specify a single letter.

Return Values

When successful, the remaining size (0 or more). A size of 2 GB or more is returned as 2 GB (2,147,483,647 bytes )
Failure: -1 (currently, VF errors can be verified with the VFGetLastError function.)

Description

Gets the remaining number of bytes for the specified drive. When the available space is obtained successfully, the number of free bytes is returned; if failed, -1 is returned.
Use the VFGetDriveFreeSizeU64 function to accurately know the precise number of bytes remaining for 2 GB or more.

See Also

VFGetDriveFreeSizeU64

Revision History

2008/12/16 Added a description about the limits on the return values
2006/05/31 Initial version


CONFIDENTIAL