IMediumAttachment Interface Reference

The IMediumAttachment interface links storage media to virtual machines. More...

List of all members.

Public Attributes

readonly attribute IMedium medium
 Medium object associated with this attachment; it can be null for removable devices.
readonly attribute wstring controller
 Name of the storage controller of this attachment; this refers to one of the controllers in IMachine::storageControllers by name.
readonly attribute long port
 Port number of this attachment.
readonly attribute long device
 Device slot number of this attachment.
readonly attribute DeviceType type
 Device type of this attachment.
readonly attribute boolean passthrough
 Pass I/O requests through to a device on the host.
readonly attribute IBandwidthGroup bandwidthGroup
 The bandwidth group this medium attachment is assigned to.


Detailed Description

The IMediumAttachment interface links storage media to virtual machines.

For each medium (IMedium) which has been attached to a storage controller (IStorageController) of a machine (IMachine) via the IMachine::attachDevice method, one instance of IMediumAttachment is added to the machine's IMachine::mediumAttachments array attribute.

Each medium attachment specifies the storage controller as well as a port and device number and the IMedium instance representing a virtual hard disk or floppy or DVD image.

For removeable media (DVDs or floppies), there are two additional options. For one, the IMedium instance can be null to represent an empty drive with no media inserted (see IMachine::mountMedium); secondly, the medium can be one of the pseudo-media for host drives listed in IHost::DVDDrives or IHost::floppyDrives.

Interface ID:
{AA4B4840-934F-454D-9A28-23E8F4235EDF}

Member Data Documentation

readonly attribute IMedium IMediumAttachment::medium

Medium object associated with this attachment; it can be null for removable devices.

readonly attribute wstring IMediumAttachment::controller

Name of the storage controller of this attachment; this refers to one of the controllers in IMachine::storageControllers by name.

readonly attribute long IMediumAttachment::port

Port number of this attachment.

See IMachine::attachDevice for the meaning of this value for the different controller types.

readonly attribute long IMediumAttachment::device

Device slot number of this attachment.

See IMachine::attachDevice for the meaning of this value for the different controller types.

readonly attribute DeviceType IMediumAttachment::type

Device type of this attachment.

readonly attribute boolean IMediumAttachment::passthrough

Pass I/O requests through to a device on the host.

The bandwidth group this medium attachment is assigned to.


Generated on Mon Dec 6 19:35:25 2010 for VirtualBox Main API by  doxygen 1.5.6