Download Oracle VM VirtualBox Programming Guide and

9 Classes (interfaces)
9.23.1.14 base (read-only)
IMedium IMedium::base
Base medium of this medium.
If this is a differencing medium, its base medium is the medium the given medium branch
starts from. For all other types of media, this property returns the medium object itself (i.e. the
same object this property is read on).
9.23.1.15 readOnly (read-only)
boolean IMedium::readOnly
Returns true if this medium is read-only and false otherwise.
A medium is considered to be read-only when its contents cannot be modified without breaking
the integrity of other parties that depend on this medium such as its child media or snapshots of
virtual machines where this medium is attached to these machines. If there are no children and
no such snapshots then there is no dependency and the medium is not read-only.
The value of this attribute can be used to determine the kind of the attachment that will
take place when attaching this medium to a virtual machine. If the value is false then the
medium will be attached directly. If the value is true then the medium will be attached indirectly
by creating a new differencing child medium for that. See the interface description for more
information.
Note that all Immutable media are always read-only while all Writethrough media are always
not.
Note: The read-only condition represented by this attribute is related to the medium
type and usage, not to the current medium state and not to the read-only state of the
storage unit.
9.23.1.16 logicalSize (read-only)
unsigned long long IMedium::logicalSize
Logical size of this medium (in megabytes), as reported to the guest OS running inside the
virtual machine this medium is attached to. The logical size is defined when the medium is
created and cannot be changed later.
Note: Reading this property on a differencing medium will return the size of its base
medium.
Note: For media whose state is state is Inaccessible, the value of this property is the
last known logical size. For NotCreated media, the returned value is zero.
143