VirtualBox Main API
Public Member Functions | Public Attributes | List of all members
IMediumFormat Interface Reference

The IMediumFormat interface represents a medium format. More...

Public Member Functions

void describeFileExtensions (out wstring[] extensions, out DeviceType[] types)
 Returns two arrays describing the supported file extensions.
void describeProperties (out wstring[] names, out wstring[] descriptions, out DataType[] types, out unsigned long[] flags, out wstring[] defaults)
 Returns several arrays describing the properties supported by this format.

Public Attributes

readonly attribute wstring id
 Identifier of this format.
readonly attribute wstring name
 Human readable description of this format.
readonly attribute
MediumFormatCapabilities[] 
capabilities
 Capabilities of the format as an array of the flags.

Detailed Description

The IMediumFormat interface represents a medium format.

    Each medium format has an associated backend which is used to handle
    media stored in this format. This interface provides information
    about the properties of the associated backend.

    Each medium format is identified by a string represented by the
    @link #id id@endlink<b></b> attribute. This string is used in calls like
    @link IVirtualBox::createHardDisk IVirtualBox::createHardDisk@endlink<b></b> to specify the desired
    format.

    The list of all supported medium formats can be obtained using
    @link ISystemProperties::mediumFormats ISystemProperties::mediumFormats@endlink<b></b>.
See Also
IMedium
Interface ID:
{6238E1CF-A17D-4EC1-8172-418BFB22B93A}

Member Function Documentation

void IMediumFormat::describeFileExtensions ( out wstring[]  extensions,
out DeviceType[]  types 
)

Returns two arrays describing the supported file extensions.

    The first array contains the supported extensions and the seconds one
    the type each extension supports. Both have the same size.

    Note that some backends do not work on files, so this array may be
    empty.
Parameters
extensionsThe array of supported extensions.
typesThe array which indicates the device type for every given extension.
See Also
IMediumFormat::capabilities
void IMediumFormat::describeProperties ( out wstring[]  names,
out wstring[]  descriptions,
out DataType[]  types,
out unsigned long[]  flags,
out wstring[]  defaults 
)

Returns several arrays describing the properties supported by this format.

    An element with the given index in each array describes one
    property. Thus, the number of elements in each returned array is the
    same and corresponds to the number of supported properties.

    The returned arrays are filled in only if the
    @link ::MediumFormatCapabilities_Properties MediumFormatCapabilities_Properties@endlink<b></b> flag is set.
    All arguments must be non-@c null.
Parameters
namesArray of property names.
descriptionsArray of property descriptions.
typesArray of property types.
flagsArray of property flags.
defaultsArray of default property values.
See Also
DataType, DataFlags

Member Data Documentation

readonly attribute wstring IMediumFormat::id

Identifier of this format.

The format identifier is a non-null non-empty ASCII string. Note that this string is case-insensitive. This means that, for example, all of the following strings:

  "VDI"
  "vdi"
  "VdI"

refer to the same medium format.

This string is used in methods of other interfaces where it is necessary to specify a medium format, such as IVirtualBox::createHardDisk.

readonly attribute wstring IMediumFormat::name

Human readable description of this format.

Mainly for use in file open dialogs.

readonly attribute MediumFormatCapabilities [] IMediumFormat::capabilities

Capabilities of the format as an array of the flags.

For the meaning of individual capability flags see MediumFormatCapabilities.