6.1-roStorageInfo

ON THIS PAGE


This object is used to report storage device usage information.

Object Creation: The roStorageInfo object is created with a parameter that specifies the path of the storage device. The path does not need to extend to the root of the storage device.

CreateObject("roStorageInfo", path As String) 

ifStorageInfo

GetFailureReason() As String

Yields additional useful information if a function return indicates an error.

GetBytesPerBlock() As Integer

Returns the size of a native block on the filesystem used by the specified storage device.

GetSizeInMegabytes() As Integer

Returns the total size (in mebibytes) of the storage device.

Important

On some filesystems that have a portion of space reserved for the super user, the following expression may not be true:  GetUsedInMegabytes() + GetFreeInMegabytes() == GetSizeInMegabytes() 

GetUsedInMegabytes() As Integer

Returns the amount (in mebibytes) of space currently used on the storage device. This amount includes the size of the pool because this class does not integrate pools into its calculations.

GetFreeInMegabytes() As Integer

Returns the available space (in mebibytes)  on the storage device.

GetFileSystemType() As String

Returns a string describing the type of filesystem used on the specified storage. The following are potential values:

  • "fat12"
  • "fat16"
  • "fat32"
  • "ext3"
  • "ntfs"
  • "hfs"
  • "Hfsplus"
GetStorageCardInfo() As Object

Returns an associative array containing details of the storage device hardware (a memory card, for example).  For SD cards, the returned data may include the following:

sd_mfr_id

Integer

Card manufacturer ID as assigned by the SD Card Association

sd_oem_id

String

Two-character card OEM identifier as assigned by the SD Card Association

sd_product_name

String

Product name, assigned by the card manufacturer (5 bytes for SD, 6 bytes for MMC)

sd_spec_vers

Integer

Version of SD spec to which the card conforms

sd_product_rev

String

Product revision assigned by the card manufacturer

sd_speed_class

String

Speed class (if any) declared by the card

sd_au_size

Integer

Size of the SD AU in bytes.

 

 

Example
si=CreateObject("roStorageInfo", "SD:/")
Print si.GetFreeInMegabytes(); "MiB free"

 

Â