VirtualBox.idl

Go to the documentation of this file.

/*
 *  DO NOT EDIT! This is a generated file.
 *
 *  Doxygen IDL definition for VirtualBox Main API (COM interfaces)
 *  generated from XIDL (XML interface definition).
 *
 *  Source    : src/VBox/Main/idl/VirtualBox.xidl
 *  Generator : src/VBox/Main/idl/doxygen.xsl
 *
 *  This IDL is generated using some generic OMG IDL-like syntax SOLELY
 *  for the purpose of generating the documentation using Doxygen and
 *  is not syntactically valid.
 *
 *  DO NOT USE THIS HEADER IN ANY OTHER WAY!
 */

const HRESULT VBOX_E_OBJECT_NOT_FOUND = 0x80BB0001;
const HRESULT VBOX_E_INVALID_VM_STATE = 0x80BB0002;
const HRESULT VBOX_E_VM_ERROR = 0x80BB0003;
const HRESULT VBOX_E_FILE_ERROR = 0x80BB0004;
const HRESULT VBOX_E_IPRT_ERROR = 0x80BB0005;
const HRESULT VBOX_E_PDM_ERROR = 0x80BB0006;
const HRESULT VBOX_E_INVALID_OBJECT_STATE = 0x80BB0007;
const HRESULT VBOX_E_HOST_ERROR = 0x80BB0008;
const HRESULT VBOX_E_NOT_SUPPORTED = 0x80BB0009;
const HRESULT VBOX_E_XML_ERROR = 0x80BB000A;
const HRESULT VBOX_E_INVALID_SESSION_STATE = 0x80BB000B;
const HRESULT VBOX_E_OBJECT_IN_USE = 0x80BB000C;
enum SettingsVersion
{
    SettingsVersion_Null = 0,
    SettingsVersion_v1_0 = 1,
    SettingsVersion_v1_1 = 2,
    SettingsVersion_v1_2 = 3,
    SettingsVersion_v1_3pre = 4,
    SettingsVersion_v1_3 = 5,
    SettingsVersion_v1_4 = 6,
    SettingsVersion_v1_5 = 7,
    SettingsVersion_v1_6 = 8,
    SettingsVersion_v1_7 = 9,
    SettingsVersion_v1_8 = 10,
    SettingsVersion_v1_9 = 11,
    SettingsVersion_Future = 12,
};

enum AccessMode
{
    AccessMode_ReadOnly = 1,
    AccessMode_ReadWrite = 2,
};

enum MachineState
{
    MachineState_Null = 0,
    MachineState_PoweredOff = 1,
    MachineState_Saved = 2,
    MachineState_Teleported = 3,
    MachineState_Aborted = 4,
    MachineState_Running = 5,
    MachineState_Paused = 6,
    MachineState_Stuck = 7,
    MachineState_Teleporting = 8,
    MachineState_LiveSnapshotting = 9,
    MachineState_Starting = 10,
    MachineState_Stopping = 11,
    MachineState_Saving = 12,
    MachineState_Restoring = 13,
    MachineState_TeleportingPausedVM = 14,
    MachineState_TeleportingIn = 15,
    MachineState_RestoringSnapshot = 16,
    MachineState_DeletingSnapshot = 17,
    MachineState_SettingUp = 18,
    MachineState_FirstOnline = 5,
    MachineState_LastOnline = 13,
    MachineState_FirstTransient = 8,
    MachineState_LastTransient = 18,
};

enum SessionState
{
    SessionState_Null = 0,
    SessionState_Closed = 1,
    SessionState_Open = 2,
    SessionState_Spawning = 3,
    SessionState_Closing = 4,
};

enum CpuPropertyType
{
    CpuPropertyType_Null = 0,
    CpuPropertyType_PAE = 1,
    CpuPropertyType_Synthetic = 2,
};

enum HWVirtExPropertyType
{
    HWVirtExPropertyType_Null = 0,
    HWVirtExPropertyType_Enabled = 1,
    HWVirtExPropertyType_Exclusive = 2,
    HWVirtExPropertyType_VPID = 3,
    HWVirtExPropertyType_NestedPaging = 4,
};

enum SessionType
{
    SessionType_Null = 0,
    SessionType_Direct = 1,
    SessionType_Remote = 2,
    SessionType_Existing = 3,
};

enum DeviceType
{
    DeviceType_Null = 0,
    DeviceType_Floppy = 1,
    DeviceType_DVD = 2,
    DeviceType_HardDisk = 3,
    DeviceType_Network = 4,
    DeviceType_USB = 5,
    DeviceType_SharedFolder = 6,
};

enum DeviceActivity
{
    DeviceActivity_Null = 0,
    DeviceActivity_Idle = 1,
    DeviceActivity_Reading = 2,
    DeviceActivity_Writing = 3,
};

enum ClipboardMode
{
    ClipboardMode_Disabled = 0,
    ClipboardMode_HostToGuest = 1,
    ClipboardMode_GuestToHost = 2,
    ClipboardMode_Bidirectional = 3,
};

enum Scope
{
    Scope_Global = 0,
    Scope_Machine = 1,
    Scope_Session = 2,
};

enum GuestStatisticType
{
    GuestStatisticType_CPULoad_Idle = 0,
    GuestStatisticType_CPULoad_Kernel = 1,
    GuestStatisticType_CPULoad_User = 2,
    GuestStatisticType_Threads = 3,
    GuestStatisticType_Processes = 4,
    GuestStatisticType_Handles = 5,
    GuestStatisticType_MemoryLoad = 6,
    GuestStatisticType_PhysMemTotal = 7,
    GuestStatisticType_PhysMemAvailable = 8,
    GuestStatisticType_PhysMemBalloon = 9,
    GuestStatisticType_MemCommitTotal = 10,
    GuestStatisticType_MemKernelTotal = 11,
    GuestStatisticType_MemKernelPaged = 12,
    GuestStatisticType_MemKernelNonpaged = 13,
    GuestStatisticType_MemSystemCache = 14,
    GuestStatisticType_PageFileSize = 15,
    GuestStatisticType_SampleNumber = 16,
    GuestStatisticType_MaxVal = 17,
};

enum BIOSBootMenuMode
{
    BIOSBootMenuMode_Disabled = 0,
    BIOSBootMenuMode_MenuOnly = 1,
    BIOSBootMenuMode_MessageAndMenu = 2,
};

enum ProcessorFeature
{
    ProcessorFeature_HWVirtEx = 0,
    ProcessorFeature_PAE = 1,
    ProcessorFeature_LongMode = 2,
    ProcessorFeature_NestedPaging = 3,
};

enum FirmwareType
{
    FirmwareType_BIOS = 1,
    FirmwareType_EFI = 2,
    FirmwareType_EFI32 = 3,
    FirmwareType_EFI64 = 4,
    FirmwareType_EFIDUAL = 5,
};

enum VFSType
{
    VFSType_File = 1,
    VFSType_Cloud = 2,
    VFSType_S3 = 3,
    VFSType_WebDav = 4,
};

enum VFSFileType
{
    VFSFileType_Unknown = 1,
    VFSFileType_Fifo = 2,
    VFSFileType_DevChar = 3,
    VFSFileType_Directory = 4,
    VFSFileType_DevBlock = 5,
    VFSFileType_File = 6,
    VFSFileType_SymLink = 7,
    VFSFileType_Socket = 8,
    VFSFileType_WhiteOut = 9,
};

enum VirtualSystemDescriptionType
{
    VirtualSystemDescriptionType_Ignore = 1,
    VirtualSystemDescriptionType_OS = 2,
    VirtualSystemDescriptionType_Name = 3,
    VirtualSystemDescriptionType_Product = 4,
    VirtualSystemDescriptionType_Vendor = 5,
    VirtualSystemDescriptionType_Version = 6,
    VirtualSystemDescriptionType_ProductUrl = 7,
    VirtualSystemDescriptionType_VendorUrl = 8,
    VirtualSystemDescriptionType_Description = 9,
    VirtualSystemDescriptionType_License = 10,
    VirtualSystemDescriptionType_Miscellaneous = 11,
    VirtualSystemDescriptionType_CPU = 12,
    VirtualSystemDescriptionType_Memory = 13,
    VirtualSystemDescriptionType_HardDiskControllerIDE = 14,
    VirtualSystemDescriptionType_HardDiskControllerSATA = 15,
    VirtualSystemDescriptionType_HardDiskControllerSCSI = 16,
    VirtualSystemDescriptionType_HardDiskImage = 17,
    VirtualSystemDescriptionType_Floppy = 18,
    VirtualSystemDescriptionType_CDROM = 19,
    VirtualSystemDescriptionType_NetworkAdapter = 20,
    VirtualSystemDescriptionType_USBController = 21,
    VirtualSystemDescriptionType_SoundCard = 22,
};

enum VirtualSystemDescriptionValueType
{
    VirtualSystemDescriptionValueType_Reference = 1,
    VirtualSystemDescriptionValueType_Original = 2,
    VirtualSystemDescriptionValueType_Auto = 3,
    VirtualSystemDescriptionValueType_ExtraConfig = 4,
};

enum HostNetworkInterfaceMediumType
{
    HostNetworkInterfaceMediumType_Unknown = 0,
    HostNetworkInterfaceMediumType_Ethernet = 1,
    HostNetworkInterfaceMediumType_PPP = 2,
    HostNetworkInterfaceMediumType_SLIP = 3,
};

enum HostNetworkInterfaceStatus
{
    HostNetworkInterfaceStatus_Unknown = 0,
    HostNetworkInterfaceStatus_Up = 1,
    HostNetworkInterfaceStatus_Down = 2,
};

enum HostNetworkInterfaceType
{
    HostNetworkInterfaceType_Bridged = 1,
    HostNetworkInterfaceType_HostOnly = 2,
};

enum MediumState
{
    MediumState_NotCreated = 0,
    MediumState_Created = 1,
    MediumState_LockedRead = 2,
    MediumState_LockedWrite = 3,
    MediumState_Inaccessible = 4,
    MediumState_Creating = 5,
    MediumState_Deleting = 6,
};

enum MediumType
{
    MediumType_Normal = 0,
    MediumType_Immutable = 1,
    MediumType_Writethrough = 2,
};

enum MediumVariant
{
    MediumVariant_Standard = 0,
    MediumVariant_VmdkSplit2G = 0x01,
    MediumVariant_VmdkStreamOptimized = 0x04,
    MediumVariant_VmdkESX = 0x08,
    MediumVariant_Fixed = 0x10000,
    MediumVariant_Diff = 0x20000,
};

enum DataType
{
    DataType_Int32 = 0,
    DataType_Int8 = 1,
    DataType_String = 2,
};

enum DataFlags
{
    DataFlags_None = 0x00,
    DataFlags_Mandatory = 0x01,
    DataFlags_Expert = 0x02,
    DataFlags_Array = 0x04,
    DataFlags_FlagMask = 0x07,
};

enum MediumFormatCapabilities
{
    MediumFormatCapabilities_Uuid = 0x01,
    MediumFormatCapabilities_CreateFixed = 0x02,
    MediumFormatCapabilities_CreateDynamic = 0x04,
    MediumFormatCapabilities_CreateSplit2G = 0x08,
    MediumFormatCapabilities_Differencing = 0x10,
    MediumFormatCapabilities_Asynchronous = 0x20,
    MediumFormatCapabilities_File = 0x40,
    MediumFormatCapabilities_Properties = 0x80,
    MediumFormatCapabilities_CapabilityMask = 0xFF,
};

enum MouseButtonState
{
    MouseButtonState_LeftButton = 0x01,
    MouseButtonState_RightButton = 0x02,
    MouseButtonState_MiddleButton = 0x04,
    MouseButtonState_WheelUp = 0x08,
    MouseButtonState_WheelDown = 0x10,
    MouseButtonState_XButton1 = 0x20,
    MouseButtonState_XButton2 = 0x40,
    MouseButtonState_MouseStateMask = 0x7F,
};

enum FramebufferPixelFormat
{
    FramebufferPixelFormat_Opaque = 0,
    FramebufferPixelFormat_FOURCC_RGB = 0x32424752,
};

enum NetworkAttachmentType
{
    NetworkAttachmentType_Null = 0,
    NetworkAttachmentType_NAT = 1,
    NetworkAttachmentType_Bridged = 2,
    NetworkAttachmentType_Internal = 3,
    NetworkAttachmentType_HostOnly = 4,
};

enum NetworkAdapterType
{
    NetworkAdapterType_Null = 0,
    NetworkAdapterType_Am79C970A = 1,
    NetworkAdapterType_Am79C973 = 2,
    NetworkAdapterType_I82540EM = 3,
    NetworkAdapterType_I82543GC = 4,
    NetworkAdapterType_I82545EM = 5,
    NetworkAdapterType_Virtio = 6,
};

enum PortMode
{
    PortMode_Disconnected = 0,
    PortMode_HostPipe = 1,
    PortMode_HostDevice = 2,
    PortMode_RawFile = 3,
};

enum USBDeviceState
{
    USBDeviceState_NotSupported = 0,
    USBDeviceState_Unavailable = 1,
    USBDeviceState_Busy = 2,
    USBDeviceState_Available = 3,
    USBDeviceState_Held = 4,
    USBDeviceState_Captured = 5,
};

enum USBDeviceFilterAction
{
    USBDeviceFilterAction_Null = 0,
    USBDeviceFilterAction_Ignore = 1,
    USBDeviceFilterAction_Hold = 2,
};

enum AudioDriverType
{
    AudioDriverType_Null = 0,
    AudioDriverType_WinMM = 1,
    AudioDriverType_OSS = 2,
    AudioDriverType_ALSA = 3,
    AudioDriverType_DirectSound = 4,
    AudioDriverType_CoreAudio = 5,
    AudioDriverType_MMPM = 6,
    AudioDriverType_Pulse = 7,
    AudioDriverType_SolAudio = 8,
};

enum AudioControllerType
{
    AudioControllerType_AC97 = 0,
    AudioControllerType_SB16 = 1,
};

enum VRDPAuthType
{
    VRDPAuthType_Null = 0,
    VRDPAuthType_External = 1,
    VRDPAuthType_Guest = 2,
};

enum StorageBus
{
    StorageBus_Null = 0,
    StorageBus_IDE = 1,
    StorageBus_SATA = 2,
    StorageBus_SCSI = 3,
    StorageBus_Floppy = 4,
};

enum StorageControllerType
{
    StorageControllerType_Null = 0,
    StorageControllerType_LsiLogic = 1,
    StorageControllerType_BusLogic = 2,
    StorageControllerType_IntelAhci = 3,
    StorageControllerType_PIIX3 = 4,
    StorageControllerType_PIIX4 = 5,
    StorageControllerType_ICH6 = 6,
    StorageControllerType_I82078 = 7,
};

interface IVirtualBoxErrorInfo : $errorinfo
{
    readonly attribute long resultCode;

    readonly attribute wstringUUID interfaceID;

    readonly attribute wstring component;

    readonly attribute wstring text;

    readonly attribute IVirtualBoxErrorInfo next;

}; /* interface IVirtualBoxErrorInfo */

interface ILocalOwner : $dispatched
{
    void setLocalObject (
        in $unknown object
    );

}; /* interface ILocalOwner */

interface IVirtualBoxCallback : $unknown
{
    void onMachineStateChange (
        in wstringUUID machineId,
        in MachineState state
    );

    void onMachineDataChange (
        in wstringUUID machineId
    );

    void onExtraDataCanChange (
        in wstringUUID machineId,
        in wstring key,
        in wstring value,
        out wstring error,
        [retval] out boolean allowChange
    );

    void onExtraDataChange (
        in wstringUUID machineId,
        in wstring key,
        in wstring value
    );

    void onMediumRegistered (
        in wstringUUID mediumId,
        in DeviceType mediumType,
        in boolean registered
    );

    void onMachineRegistered (
        in wstringUUID machineId,
        in boolean registered
    );

    void onSessionStateChange (
        in wstringUUID machineId,
        in SessionState state
    );

    void onSnapshotTaken (
        in wstringUUID machineId,
        in wstringUUID snapshotId
    );

    void onSnapshotDiscarded (
        in wstringUUID machineId,
        in wstringUUID snapshotId
    );

    void onSnapshotChange (
        in wstringUUID machineId,
        in wstringUUID snapshotId
    );

    void onGuestPropertyChange (
        in wstringUUID machineId,
        in wstring name,
        in wstring value,
        in wstring flags
    );

}; /* interface IVirtualBoxCallback */

interface IDHCPServer : $unknown
{
    attribute boolean enabled;

    readonly attribute wstring IPAddress;

    readonly attribute wstring networkMask;

    readonly attribute wstring networkName;

    readonly attribute wstring lowerIP;

    readonly attribute wstring upperIP;

    void setConfiguration (
        in wstring IPAddress,
        in wstring networkMask,
        in wstring FromIPAddress,
        in wstring ToIPAddress
    );

    void start (
        in wstring networkName,
        in wstring trunkName,
        in wstring trunkType
    );

    void stop();

}; /* interface IDHCPServer */

interface IVirtualBox : $dispatched
{
    readonly attribute wstring version;

    readonly attribute unsigned long revision;

    readonly attribute wstring packageType;

    readonly attribute wstring homeFolder;

    readonly attribute wstring settingsFilePath;

    readonly attribute IHost host;

    readonly attribute ISystemProperties systemProperties;

    readonly attribute IMachine[] machines;

    readonly attribute IMedium[] hardDisks;

    readonly attribute IMedium[] DVDImages;

    readonly attribute IMedium[] floppyImages;

    readonly attribute IProgress[] progressOperations;

    readonly attribute IGuestOSType[] guestOSTypes;

    readonly attribute ISharedFolder[] sharedFolders;

    readonly attribute IPerformanceCollector performanceCollector;

    readonly attribute IDHCPServer[] DHCPServers;

    void createMachine (
        in wstring name,
        in wstring osTypeId,
        in wstring baseFolder,
        in wstringUUID id,
        [retval] out IMachine machine
    );

    void createLegacyMachine (
        in wstring name,
        in wstring osTypeId,
        in wstring settingsFile,
        in wstringUUID id,
        [retval] out IMachine machine
    );

    void openMachine (
        in wstring settingsFile,
        [retval] out IMachine machine
    );

    void registerMachine (
        in IMachine machine
    );

    void getMachine (
        in wstringUUID id,
        [retval] out IMachine machine
    );

    void findMachine (
        in wstring name,
        [retval] out IMachine machine
    );

    void unregisterMachine (
        in wstringUUID id,
        [retval] out IMachine machine
    );

    void createAppliance (
        [retval] out IAppliance appliance
    );

    void createHardDisk (
        in wstring format,
        in wstring location,
        [retval] out IMedium medium
    );

    void openHardDisk (
        in wstring location,
        in AccessMode accessMode,
        in boolean setImageId,
        in wstringUUID imageId,
        in boolean setParentId,
        in wstringUUID parentId,
        [retval] out IMedium medium
    );

    void getHardDisk (
        in wstringUUID id,
        [retval] out IMedium medium
    );

    void findHardDisk (
        in wstring location,
        [retval] out IMedium medium
    );

    void openDVDImage (
        in wstring location,
        in wstringUUID id,
        [retval] out IMedium image
    );

    void getDVDImage (
        in wstringUUID id,
        [retval] out IMedium image
    );

    void findDVDImage (
        in wstring location,
        [retval] out IMedium image
    );

    void openFloppyImage (
        in wstring location,
        in wstringUUID id,
        [retval] out IMedium image
    );

    void getFloppyImage (
        in wstringUUID id,
        [retval] out IMedium image
    );

    void findFloppyImage (
        in wstring location,
        [retval] out IMedium image
    );

    void getGuestOSType (
        in wstringUUID id,
        [retval] out IGuestOSType type
    );

    void createSharedFolder (
        in wstring name,
        in wstring hostPath,
        in boolean writable
    );

    void removeSharedFolder (
        in wstring name
    );

    void getExtraDataKeys (
        [retval] out wstring[] value
    );

    void getExtraData (
        in wstring key,
        [retval] out wstring value
    );

    void setExtraData (
        in wstring key,
        in wstring value
    );

    void openSession (
        in ISession session,
        in wstringUUID machineId
    );

    void openRemoteSession (
        in ISession session,
        in wstringUUID machineId,
        in wstring type,
        in wstring environment,
        [retval] out IProgress progress
    );

    void openExistingSession (
        in ISession session,
        in wstringUUID machineId
    );

    void registerCallback (
        in IVirtualBoxCallback callback
    );

    void unregisterCallback (
        in IVirtualBoxCallback callback
    );

    void waitForPropertyChange (
        in wstring what,
        in unsigned long timeout,
        out wstring changed,
        out wstring values
    );

    void createDHCPServer (
        in wstring name,
        [retval] out IDHCPServer server
    );

    void findDHCPServerByNetworkName (
        in wstring name,
        [retval] out IDHCPServer server
    );

    void removeDHCPServer (
        in IDHCPServer server
    );

    void checkFirmwarePresent (
        in FirmwareType firmwareType,
        in wstring version,
        out wstring url,
        out wstring file,
        [retval] out boolean result
    );

}; /* interface IVirtualBox */

interface IVFSExplorer : $unknown
{
    readonly attribute wstring path;

    readonly attribute VFSType type;

    void update (
        [retval] out IProgress aProgress
    );

    void cd (
        in wstring aDir,
        [retval] out IProgress aProgress
    );

    void cdUp (
        [retval] out IProgress aProgress
    );

    void entryList (
        out wstring[] aNames,
        out unsigned long[] aTypes
    );

    void exists (
        in wstring[] aNames,
        [retval] out wstring[] aExists
    );

    void remove (
        in wstring[] aNames,
        [retval] out IProgress aProgress
    );

}; /* interface IVFSExplorer */

interface IAppliance : $unknown
{
    readonly attribute wstring path;

    readonly attribute wstring[] disks;

    readonly attribute IVirtualSystemDescription[] virtualSystemDescriptions;

    void read (
        in wstring file,
        [retval] out IProgress aProgress
    );

    void interpret();

    void importMachines (
        [retval] out IProgress aProgress
    );

    void createVFSExplorer (
        in wstring aUri,
        [retval] out IVFSExplorer aExplorer
    );

    void write (
        in wstring format,
        in wstring path,
        [retval] out IProgress aProgress
    );

    void getWarnings (
        [retval] out wstring[] aWarnings
    );

}; /* interface IAppliance */

interface IVirtualSystemDescription : $unknown
{
    readonly attribute unsigned long count;

    void getDescription (
        out VirtualSystemDescriptionType[] aTypes,
        out wstring[] aRefs,
        out wstring[] aOvfValues,
        out wstring[] aVBoxValues,
        out wstring[] aExtraConfigValues
    );

    void getDescriptionByType (
        in VirtualSystemDescriptionType aType,
        out VirtualSystemDescriptionType[] aTypes,
        out wstring[] aRefs,
        out wstring[] aOvfValues,
        out wstring[] aVBoxValues,
        out wstring[] aExtraConfigValues
    );

    void getValuesByType (
        in VirtualSystemDescriptionType aType,
        in VirtualSystemDescriptionValueType aWhich,
        [retval] out wstring[] aValues
    );

    void setFinalValues (
        in boolean[] aEnabled,
        in wstring[] aVBoxValues,
        in wstring[] aExtraConfigValues
    );

    void addDescription (
        in VirtualSystemDescriptionType aType,
        in wstring aVBoxValue,
        in wstring aExtraConfigValue
    );

}; /* interface IVirtualSystemDescription */

interface IInternalMachineControl : $unknown
{
    void setRemoveSavedState (
        in boolean aRemove
    );

    void updateState (
        in MachineState state
    );

    void getIPCId (
        [retval] out wstring id
    );

    void runUSBDeviceFilters (
        in IUSBDevice device,
        out boolean matched,
        out unsigned long maskedInterfaces
    );

    void captureUSBDevice (
        in wstringUUID id
    );

    void detachUSBDevice (
        in wstringUUID id,
        in boolean done
    );

    void autoCaptureUSBDevices();

    void detachAllUSBDevices (
        in boolean done
    );

    void onSessionEnd (
        in ISession session,
        [retval] out IProgress progress
    );

    void beginSavingState (
        in IProgress progress,
        out wstring stateFilePath
    );

    void endSavingState (
        in boolean success
    );

    void adoptSavedState (
        in wstring savedStateFile
    );

    void beginTakingSnapshot (
        in IConsole initiator,
        in wstring name,
        in wstring description,
        in IProgress consoleProgress,
        in boolean fTakingSnapshotOnline,
        out wstring stateFilePath
    );

    void endTakingSnapshot (
        in boolean success
    );

    void deleteSnapshot (
        in IConsole initiator,
        in wstringUUID id,
        out MachineState machineState,
        [retval] out IProgress progress
    );

    void restoreSnapshot (
        in IConsole initiator,
        in ISnapshot snapshot,
        out MachineState machineState,
        [retval] out IProgress progress
    );

    void pullGuestProperties (
        out wstring[] name,
        out wstring[] value,
        out unsigned long long[] timestamp,
        out wstring[] flags
    );

    void pushGuestProperties (
        in wstring[] name,
        in wstring[] value,
        in unsigned long long[] timestamp,
        in wstring[] flags
    );

    void pushGuestProperty (
        in wstring name,
        in wstring value,
        in unsigned long long timestamp,
        in wstring flags
    );

    void lockMedia();

    void unlockMedia();

}; /* interface IInternalMachineControl */

interface IBIOSSettings : $unknown
{
    attribute boolean logoFadeIn;

    attribute boolean logoFadeOut;

    attribute unsigned long logoDisplayTime;

    attribute wstring logoImagePath;

    attribute BIOSBootMenuMode bootMenuMode;

    attribute boolean ACPIEnabled;

    attribute boolean IOAPICEnabled;

    attribute long long timeOffset;

    attribute boolean PXEDebugEnabled;

}; /* interface IBIOSSettings */

interface IMachine : $unknown
{
    readonly attribute IVirtualBox parent;

    readonly attribute boolean accessible;

    readonly attribute IVirtualBoxErrorInfo accessError;

    attribute wstring name;

    attribute wstring description;

    readonly attribute wstringUUID id;

    attribute wstring OSTypeId;

    attribute wstring HardwareVersion;

    attribute wstringUUID hardwareUUID;

    attribute unsigned long CPUCount;

    attribute unsigned long memorySize;

    attribute unsigned long memoryBalloonSize;

    attribute unsigned long statisticsUpdateInterval;

    attribute unsigned long VRAMSize;

    attribute boolean accelerate3DEnabled;

    attribute boolean accelerate2DVideoEnabled;

    attribute unsigned long monitorCount;

    readonly attribute IBIOSSettings BIOSSettings;

    attribute FirmwareType firmwareType;

    attribute wstring snapshotFolder;

    readonly attribute IVRDPServer VRDPServer;

    readonly attribute IMediumAttachment[] mediumAttachments;

    readonly attribute IUSBController USBController;

    readonly attribute IAudioAdapter audioAdapter;

    readonly attribute IStorageController[] storageControllers;

    readonly attribute wstring settingsFilePath;

    readonly attribute boolean settingsModified;

    readonly attribute SessionState sessionState;

    readonly attribute wstring sessionType;

    readonly attribute unsigned long sessionPid;

    readonly attribute MachineState state;

    readonly attribute long long lastStateChange;

    readonly attribute wstring stateFilePath;

    readonly attribute wstring logFolder;

    readonly attribute ISnapshot currentSnapshot;

    readonly attribute unsigned long snapshotCount;

    readonly attribute boolean currentStateModified;

    readonly attribute ISharedFolder[] sharedFolders;

    attribute ClipboardMode clipboardMode;

    attribute wstring guestPropertyNotificationPatterns;

    attribute boolean teleporterEnabled;

    attribute unsigned long teleporterPort;

    attribute wstring teleporterAddress;

    attribute wstring teleporterPassword;

    void setBootOrder (
        in unsigned long position,
        in DeviceType device
    );

    void getBootOrder (
        in unsigned long position,
        [retval] out DeviceType device
    );

    void attachDevice (
        in wstring name,
        in long controllerPort,
        in long device,
        in DeviceType type,
        in wstringUUID id
    );

    void detachDevice (
        in wstring name,
        in long controllerPort,
        in long device
    );

    void passthroughDevice (
        in wstring name,
        in long controllerPort,
        in long device,
        in boolean passthrough
    );

    void mountMedium (
        in wstring name,
        in long controllerPort,
        in long device,
        in wstringUUID medium,
        in boolean force
    );

    void getMedium (
        in wstring name,
        in long controllerPort,
        in long device,
        [retval] out IMedium medium
    );

    void getMediumAttachmentsOfController (
        in wstring name,
        [retval] out IMediumAttachment[] mediumAttachments
    );

    void getMediumAttachment (
        in wstring name,
        in long controllerPort,
        in long device,
        [retval] out IMediumAttachment attachment
    );

    void getNetworkAdapter (
        in unsigned long slot,
        [retval] out INetworkAdapter adapter
    );

    void addStorageController (
        in wstring name,
        in StorageBus connectionType,
        [retval] out IStorageController controller
    );

    void getStorageControllerByName (
        in wstring name,
        [retval] out IStorageController storageController
    );

    void getStorageControllerByInstance (
        in unsigned long instance,
        [retval] out IStorageController storageController
    );

    void removeStorageController (
        in wstring name
    );

    void getSerialPort (
        in unsigned long slot,
        [retval] out ISerialPort port
    );

    void getParallelPort (
        in unsigned long slot,
        [retval] out IParallelPort port
    );

    void getExtraDataKeys (
        [retval] out wstring[] value
    );

    void getExtraData (
        in wstring key,
        [retval] out wstring value
    );

    void setExtraData (
        in wstring key,
        in wstring value
    );

    void getCpuProperty (
        in CpuPropertyType property,
        [retval] out boolean value
    );

    void setCpuProperty (
        in CpuPropertyType property,
        in boolean value
    );

    void getCpuIdLeaf (
        in unsigned long id,
        out unsigned long valEax,
        out unsigned long valEbx,
        out unsigned long valEcx,
        out unsigned long valEdx
    );

    void setCpuIdLeaf (
        in unsigned long id,
        in unsigned long valEax,
        in unsigned long valEbx,
        in unsigned long valEcx,
        in unsigned long valEdx
    );

    void removeCpuIdLeaf (
        in unsigned long id
    );

    void removeAllCpuIdLeafs();

    void getHWVirtExProperty (
        in HWVirtExPropertyType property,
        [retval] out boolean value
    );

    void setHWVirtExProperty (
        in HWVirtExPropertyType property,
        in boolean value
    );

    void saveSettings();

    void discardSettings();

    void deleteSettings();

    void export (
        in IAppliance aAppliance,
        [retval] out IVirtualSystemDescription aDescription
    );

    void getSnapshot (
        in wstringUUID id,
        [retval] out ISnapshot snapshot
    );

    void findSnapshot (
        in wstring name,
        [retval] out ISnapshot snapshot
    );

    void setCurrentSnapshot (
        in wstringUUID id
    );

    void createSharedFolder (
        in wstring name,
        in wstring hostPath,
        in boolean writable
    );

    void removeSharedFolder (
        in wstring name
    );

    void canShowConsoleWindow (
        [retval] out boolean canShow
    );

    void showConsoleWindow (
        [retval] out unsigned long long winId
    );

    void getGuestProperty (
        in wstring name,
        out wstring value,
        out unsigned long long timestamp,
        out wstring flags
    );

    void getGuestPropertyValue (
        in wstring property,
        [retval] out wstring value
    );

    void getGuestPropertyTimestamp (
        in wstring property,
        [retval] out unsigned long long value
    );

    void setGuestProperty (
        in wstring property,
        in wstring value,
        in wstring flags
    );

    void setGuestPropertyValue (
        in wstring property,
        in wstring value
    );

    void enumerateGuestProperties (
        in wstring patterns,
        out wstring[] name,
        out wstring[] value,
        out unsigned long long[] timestamp,
        out wstring[] flags
    );

    void querySavedThumbnailSize (
        out unsigned long size,
        out unsigned long width,
        out unsigned long height
    );

    void readSavedThumbnailToArray (
        in boolean BGR,
        out unsigned long width,
        out unsigned long height,
        [retval] out octet[] data
    );

    void querySavedScreenshotPNGSize (
        out unsigned long size,
        out unsigned long width,
        out unsigned long height
    );

    void readSavedScreenshotPNGToArray (
        out unsigned long width,
        out unsigned long height,
        [retval] out octet[] data
    );

}; /* interface IMachine */

interface IConsoleCallback : $unknown
{
    void onMousePointerShapeChange (
        in boolean visible,
        in boolean alpha,
        in unsigned long xHot,
        in unsigned long yHot,
        in unsigned long width,
        in unsigned long height,
        in octetPtr shape
    );

    void onMouseCapabilityChange (
        in boolean supportsAbsolute,
        in boolean needsHostCursor
    );

    void onKeyboardLedsChange (
        in boolean numLock,
        in boolean capsLock,
        in boolean scrollLock
    );

    void onStateChange (
        in MachineState state
    );

    void onAdditionsStateChange();

    void onNetworkAdapterChange (
        in INetworkAdapter networkAdapter
    );

    void onSerialPortChange (
        in ISerialPort serialPort
    );

    void onParallelPortChange (
        in IParallelPort parallelPort
    );

    void onStorageControllerChange();

    void onMediumChange (
        in IMediumAttachment mediumAttachment
    );

    void onVRDPServerChange();

    void onRemoteDisplayInfoChange();

    void onUSBControllerChange();

    void onUSBDeviceStateChange (
        in IUSBDevice device,
        in boolean attached,
        in IVirtualBoxErrorInfo error
    );

    void onSharedFolderChange (
        in Scope scope
    );

    void onRuntimeError (
        in boolean fatal,
        in wstring id,
        in wstring message
    );

    void onCanShowWindow (
        [retval] out boolean canShow
    );

    void onShowWindow (
        [retval] out unsigned long long winId
    );

}; /* interface IConsoleCallback */

interface IRemoteDisplayInfo : $unknown
{
    readonly attribute boolean active;

    readonly attribute long port;

    readonly attribute unsigned long numberOfClients;

    readonly attribute long long beginTime;

    readonly attribute long long endTime;

    readonly attribute unsigned long long bytesSent;

    readonly attribute unsigned long long bytesSentTotal;

    readonly attribute unsigned long long bytesReceived;

    readonly attribute unsigned long long bytesReceivedTotal;

    readonly attribute wstring user;

    readonly attribute wstring domain;

    readonly attribute wstring clientName;

    readonly attribute wstring clientIP;

    readonly attribute unsigned long clientVersion;

    readonly attribute unsigned long encryptionStyle;

}; /* interface IRemoteDisplayInfo */

interface IConsole : $unknown
{
    readonly attribute IMachine machine;

    readonly attribute MachineState state;

    readonly attribute IGuest guest;

    readonly attribute IKeyboard keyboard;

    readonly attribute IMouse mouse;

    readonly attribute IDisplay display;

    readonly attribute IMachineDebugger debugger;

    readonly attribute IUSBDevice[] USBDevices;

    readonly attribute IHostUSBDevice[] remoteUSBDevices;

    readonly attribute ISharedFolder[] sharedFolders;

    readonly attribute IRemoteDisplayInfo remoteDisplayInfo;

    void powerUp (
        [retval] out IProgress progress
    );

    void powerUpPaused (
        [retval] out IProgress progress
    );

    void powerDown (
        [retval] out IProgress progress
    );

    void reset();

    void pause();

    void resume();

    void powerButton();

    void sleepButton();

    void getPowerButtonHandled (
        [retval] out boolean handled
    );

    void getGuestEnteredACPIMode (
        [retval] out boolean entered
    );

    void saveState (
        [retval] out IProgress progress
    );

    void adoptSavedState (
        in wstring savedStateFile
    );

    void forgetSavedState (
        in boolean remove
    );

    void getDeviceActivity (
        in DeviceType type,
        [retval] out DeviceActivity activity
    );

    void attachUSBDevice (
        in wstringUUID id
    );

    void detachUSBDevice (
        in wstringUUID id,
        [retval] out IUSBDevice device
    );

    void findUSBDeviceByAddress (
        in wstring name,
        [retval] out IUSBDevice device
    );

    void findUSBDeviceById (
        in wstringUUID id,
        [retval] out IUSBDevice device
    );

    void createSharedFolder (
        in wstring name,
        in wstring hostPath,
        in boolean writable
    );

    void removeSharedFolder (
        in wstring name
    );

    void takeSnapshot (
        in wstring name,
        in wstring description,
        [retval] out IProgress progress
    );

    void deleteSnapshot (
        in wstringUUID id,
        [retval] out IProgress progress
    );

    void restoreSnapshot (
        in ISnapshot snapshot,
        [retval] out IProgress progress
    );

    void teleport (
        in wstring hostname,
        in unsigned long tcpport,
        in wstring password,
        in unsigned long maxDowntime,
        [retval] out IProgress progress
    );

    void registerCallback (
        in IConsoleCallback callback
    );

    void unregisterCallback (
        in IConsoleCallback callback
    );

}; /* interface IConsole */

interface IHostNetworkInterface : $unknown
{
    readonly attribute wstring name;

    readonly attribute wstringUUID id;

    readonly attribute wstring networkName;

    readonly attribute boolean dhcpEnabled;

    readonly attribute wstring IPAddress;

    readonly attribute wstring networkMask;

    readonly attribute boolean IPV6Supported;

    readonly attribute wstring IPV6Address;

    readonly attribute unsigned long IPV6NetworkMaskPrefixLength;

    readonly attribute wstring hardwareAddress;

    readonly attribute HostNetworkInterfaceMediumType mediumType;

    readonly attribute HostNetworkInterfaceStatus status;

    readonly attribute HostNetworkInterfaceType interfaceType;

    void enableStaticIpConfig (
        in wstring IPAddress,
        in wstring networkMask
    );

    void enableStaticIpConfigV6 (
        in wstring IPV6Address,
        in unsigned long IPV6NetworkMaskPrefixLength
    );

    void enableDynamicIpConfig();

    void dhcpRediscover();

}; /* interface IHostNetworkInterface */

interface IHost : $unknown
{
    readonly attribute IMedium[] DVDDrives;

    readonly attribute IMedium[] floppyDrives;

    readonly attribute IHostUSBDevice[] USBDevices;

    readonly attribute IHostUSBDeviceFilter[] USBDeviceFilters;

    readonly attribute IHostNetworkInterface[] networkInterfaces;

    readonly attribute unsigned long processorCount;

    readonly attribute unsigned long processorOnlineCount;

    readonly attribute unsigned long memorySize;

    readonly attribute unsigned long memoryAvailable;

    readonly attribute wstring operatingSystem;

    readonly attribute wstring OSVersion;

    readonly attribute long long UTCTime;

    readonly attribute boolean Acceleration3DAvailable;

    void getProcessorSpeed (
        in unsigned long cpuId,
        [retval] out unsigned long speed
    );

    void getProcessorFeature (
        in ProcessorFeature feature,
        [retval] out boolean supported
    );

    void getProcessorDescription (
        in unsigned long cpuId,
        [retval] out wstring description
    );

    void getProcessorCpuIdLeaf (
        in unsigned long cpuId,
        in unsigned long leaf,
        in unsigned long subLeaf,
        out unsigned long valEax,
        out unsigned long valEbx,
        out unsigned long valEcx,
        out unsigned long valEdx
    );

    void createHostOnlyNetworkInterface (
        out IHostNetworkInterface hostInterface,
        [retval] out IProgress progress
    );

    void removeHostOnlyNetworkInterface (
        in wstringUUID id,
        [retval] out IProgress progress
    );

    void createUSBDeviceFilter (
        in wstring name,
        [retval] out IHostUSBDeviceFilter filter
    );

    void insertUSBDeviceFilter (
        in unsigned long position,
        in IHostUSBDeviceFilter filter
    );

    void removeUSBDeviceFilter (
        in unsigned long position
    );

    void findHostDVDDrive (
        in wstring name,
        [retval] out IMedium drive
    );

    void findHostFloppyDrive (
        in wstring name,
        [retval] out IMedium drive
    );

    void findHostNetworkInterfaceByName (
        in wstring name,
        [retval] out IHostNetworkInterface networkInterface
    );

    void findHostNetworkInterfaceById (
        in wstringUUID id,
        [retval] out IHostNetworkInterface networkInterface
    );

    void findHostNetworkInterfacesOfType (
        in HostNetworkInterfaceType type,
        [retval] out IHostNetworkInterface[] networkInterfaces
    );

    void findUSBDeviceById (
        in wstringUUID id,
        [retval] out IHostUSBDevice device
    );

    void findUSBDeviceByAddress (
        in wstring name,
        [retval] out IHostUSBDevice device
    );

}; /* interface IHost */

interface ISystemProperties : $unknown
{
    readonly attribute unsigned long minGuestRAM;

    readonly attribute unsigned long maxGuestRAM;

    readonly attribute unsigned long minGuestVRAM;

    readonly attribute unsigned long maxGuestVRAM;

    readonly attribute unsigned long minGuestCPUCount;

    readonly attribute unsigned long maxGuestCPUCount;

    readonly attribute unsigned long long maxVDISize;

    readonly attribute unsigned long networkAdapterCount;

    readonly attribute unsigned long serialPortCount;

    readonly attribute unsigned long parallelPortCount;

    readonly attribute unsigned long maxBootPosition;

    attribute wstring defaultMachineFolder;

    attribute wstring defaultHardDiskFolder;

    readonly attribute IMediumFormat[] mediumFormats;

    attribute wstring defaultHardDiskFormat;

    attribute wstring remoteDisplayAuthLibrary;

    attribute wstring webServiceAuthLibrary;

    attribute unsigned long LogHistoryCount;

    readonly attribute AudioDriverType defaultAudioDriver;

    void getMaxDevicesPerPortForStorageBus (
        in StorageBus bus,
        [retval] out unsigned long maxDevicesPerPort
    );

    void getMinPortCountForStorageBus (
        in StorageBus bus,
        [retval] out unsigned long minPortCount
    );

    void getMaxPortCountForStorageBus (
        in StorageBus bus,
        [retval] out unsigned long maxPortCount
    );

    void getMaxInstancesOfStorageBus (
        in StorageBus bus,
        [retval] out unsigned long maxInstances
    );

    void getDeviceTypesForStorageBus (
        in StorageBus bus,
        [retval] out DeviceType[] deviceTypes
    );

}; /* interface ISystemProperties */

interface IGuestOSType : $unknown
{
    readonly attribute wstring familyId;

    readonly attribute wstring familyDescription;

    readonly attribute wstring id;

    readonly attribute wstring description;

    readonly attribute boolean is64Bit;

    readonly attribute boolean recommendedIOAPIC;

    readonly attribute boolean recommendedVirtEx;

    readonly attribute unsigned long recommendedRAM;

    readonly attribute unsigned long recommendedVRAM;

    readonly attribute unsigned long recommendedHDD;

    readonly attribute NetworkAdapterType adapterType;

}; /* interface IGuestOSType */

interface IGuest : $unknown
{
    readonly attribute wstring OSTypeId;

    readonly attribute boolean additionsActive;

    readonly attribute wstring additionsVersion;

    readonly attribute boolean supportsSeamless;

    readonly attribute boolean supportsGraphics;

    attribute unsigned long memoryBalloonSize;

    attribute unsigned long statisticsUpdateInterval;

    void setCredentials (
        in wstring userName,
        in wstring password,
        in wstring domain,
        in boolean allowInteractiveLogon
    );

    void getStatistic (
        in unsigned long cpuId,
        in GuestStatisticType statistic,
        [retval] out unsigned long statVal
    );

}; /* interface IGuest */

interface IProgress : $unknown
{
    readonly attribute wstringUUID id;

    readonly attribute wstring description;

    readonly attribute $unknown initiator;

    readonly attribute boolean cancelable;

    readonly attribute unsigned long percent;

    readonly attribute long timeRemaining;

    readonly attribute boolean completed;

    readonly attribute boolean canceled;

    readonly attribute long resultCode;

    readonly attribute IVirtualBoxErrorInfo errorInfo;

    readonly attribute unsigned long operationCount;

    readonly attribute unsigned long operation;

    readonly attribute wstring operationDescription;

    readonly attribute unsigned long operationPercent;

    attribute unsigned long timeout;

    void setCurrentOperationProgress (
        in unsigned long percent
    );

    void setNextOperation (
        in wstring nextOperationDescription,
        in unsigned long nextOperationsWeight
    );

    void waitForCompletion (
        in long timeout
    );

    void waitForOperationCompletion (
        in unsigned long operation,
        in long timeout
    );

    void cancel();

}; /* interface IProgress */

interface ISnapshot : $unknown
{
    readonly attribute wstringUUID id;

    attribute wstring name;

    attribute wstring description;

    readonly attribute long long timeStamp;

    readonly attribute boolean online;

    readonly attribute IMachine machine;

    readonly attribute ISnapshot parent;

    readonly attribute ISnapshot[] children;

}; /* interface ISnapshot */

interface IMediumAttachment : $unknown
{
    readonly attribute IMedium medium;

    readonly attribute wstring controller;

    readonly attribute long port;

    readonly attribute long device;

    readonly attribute DeviceType type;

    readonly attribute boolean passthrough;

}; /* interface IMediumAttachment */

interface IMedium : $unknown
{
    readonly attribute wstringUUID id;

    attribute wstring description;

    readonly attribute MediumState state;

    attribute wstring location;

    readonly attribute wstring name;

    readonly attribute DeviceType deviceType;

    readonly attribute boolean hostDrive;

    readonly attribute unsigned long long size;

    readonly attribute wstring format;

    attribute MediumType type;

    readonly attribute IMedium parent;

    readonly attribute IMedium[] children;

    readonly attribute IMedium base;

    readonly attribute boolean readOnly;

    readonly attribute unsigned long long logicalSize;

    attribute boolean autoReset;

    readonly attribute wstring lastAccessError;

    readonly attribute wstringUUID[] machineIds;

    void refreshState (
        [retval] out MediumState state
    );

    void getSnapshotIds (
        in wstringUUID machineId,
        [retval] out wstringUUID[] snapshotIds
    );

    void lockRead (
        [retval] out MediumState state
    );

    void unlockRead (
        [retval] out MediumState state
    );

    void lockWrite (
        [retval] out MediumState state
    );

    void unlockWrite (
        [retval] out MediumState state
    );

    void close();

    void getProperty (
        in wstring name,
        [retval] out wstring value
    );

    void setProperty (
        in wstring name,
        in wstring value
    );

    void getProperties (
        in wstring names,
        out wstring[] returnNames,
        [retval] out wstring[] returnValues
    );

    void setProperties (
        in wstring[] names,
        in wstring[] values
    );

    void createBaseStorage (
        in unsigned long long logicalSize,
        in MediumVariant variant,
        [retval] out IProgress progress
    );

    void deleteStorage (
        [retval] out IProgress progress
    );

    void createDiffStorage (
        in IMedium target,
        in MediumVariant variant,
        [retval] out IProgress progress
    );

    void mergeTo (
        in wstringUUID targetId,
        [retval] out IProgress progress
    );

    void cloneTo (
        in IMedium target,
        in MediumVariant variant,
        in IMedium parent,
        [retval] out IProgress progress
    );

    void compact (
        [retval] out IProgress progress
    );

    void resize (
        in unsigned long long logicalSize,
        [retval] out IProgress progress
    );

    void reset (
        [retval] out IProgress progress
    );

}; /* interface IMedium */

interface IMediumFormat : $unknown
{
    readonly attribute wstring id;

    readonly attribute wstring name;

    readonly attribute wstring[] fileExtensions;

    readonly attribute unsigned long capabilities;

    void describeProperties (
        out wstring[] names,
        out wstring[] description,
        out DataType[] types,
        out unsigned long[] flags,
        out wstring[] defaults
    );

}; /* interface IMediumFormat */

interface IKeyboard : $unknown
{
    void putScancode (
        in long scancode
    );

    void putScancodes (
        in long[] scancodes,
        [retval] out unsigned long codesStored
    );

    void putCAD();

}; /* interface IKeyboard */

interface IMouse : $unknown
{
    readonly attribute boolean absoluteSupported;

    void putMouseEvent (
        in long dx,
        in long dy,
        in long dz,
        in long dw,
        in long buttonState
    );

    void putMouseEventAbsolute (
        in long x,
        in long y,
        in long dz,
        in long dw,
        in long buttonState
    );

}; /* interface IMouse */

interface IFramebuffer : $unknown
{
    readonly attribute octetPtr address;

    readonly attribute unsigned long width;

    readonly attribute unsigned long height;

    readonly attribute unsigned long bitsPerPixel;

    readonly attribute unsigned long bytesPerLine;

    readonly attribute unsigned long pixelFormat;

    readonly attribute boolean usesGuestVRAM;

    readonly attribute unsigned long heightReduction;

    readonly attribute IFramebufferOverlay overlay;

    readonly attribute unsigned long long winId;

    void lock();

    void unlock();

    void notifyUpdate (
        in unsigned long x,
        in unsigned long y,
        in unsigned long width,
        in unsigned long height
    );

    void requestResize (
        in unsigned long screenId,
        in unsigned long pixelFormat,
        in octetPtr VRAM,
        in unsigned long bitsPerPixel,
        in unsigned long bytesPerLine,
        in unsigned long width,
        in unsigned long height,
        [retval] out boolean finished
    );

    void videoModeSupported (
        in unsigned long width,
        in unsigned long height,
        in unsigned long bpp,
        [retval] out boolean supported
    );

    void getVisibleRegion (
        in octetPtr rectangles,
        in unsigned long count,
        [retval] out unsigned long countCopied
    );

    void setVisibleRegion (
        in octetPtr rectangles,
        in unsigned long count
    );

    void processVHWACommand (
        in octetPtr command
    );

}; /* interface IFramebuffer */

interface IFramebufferOverlay : IFramebuffer
{
    readonly attribute unsigned long x;

    readonly attribute unsigned long y;

    attribute boolean visible;

    attribute unsigned long alpha;

    void move (
        in unsigned long x,
        in unsigned long y
    );

}; /* interface IFramebufferOverlay */

interface IDisplay : $unknown
{
    readonly attribute unsigned long width;

    readonly attribute unsigned long height;

    readonly attribute unsigned long bitsPerPixel;

    void setFramebuffer (
        in unsigned long screenId,
        in IFramebuffer framebuffer
    );

    void getFramebuffer (
        in unsigned long screenId,
        out IFramebuffer framebuffer,
        out long xOrigin,
        out long yOrigin
    );

    void setVideoModeHint (
        in unsigned long width,
        in unsigned long height,
        in unsigned long bitsPerPixel,
        in unsigned long display
    );

    void setSeamlessMode (
        in boolean enabled
    );

    void takeScreenShot (
        in octetPtr address,
        in unsigned long width,
        in unsigned long height
    );

    void takeScreenShotSlow (
        in unsigned long width,
        in unsigned long height,
        [retval] out octet[] screenData
    );

    void drawToScreen (
        in octetPtr address,
        in unsigned long x,
        in unsigned long y,
        in unsigned long width,
        in unsigned long height
    );

    void invalidateAndUpdate();

    void resizeCompleted (
        in unsigned long screenId
    );

    void updateCompleted();

    void completeVHWACommand (
        in octetPtr command
    );

}; /* interface IDisplay */

interface INetworkAdapter : $unknown
{
    attribute NetworkAdapterType adapterType;

    readonly attribute unsigned long slot;

    attribute boolean enabled;

    attribute wstring MACAddress;

    readonly attribute NetworkAttachmentType attachmentType;

    attribute wstring hostInterface;

    attribute wstring internalNetwork;

    attribute wstring NATNetwork;

    attribute boolean cableConnected;

    attribute unsigned long lineSpeed;

    attribute boolean traceEnabled;

    attribute wstring traceFile;

    void attachToNAT();

    void attachToBridgedInterface();

    void attachToInternalNetwork();

    void attachToHostOnlyInterface();

    void detach();

}; /* interface INetworkAdapter */

interface ISerialPort : $unknown
{
    readonly attribute unsigned long slot;

    attribute boolean enabled;

    attribute unsigned long IOBase;

    attribute unsigned long IRQ;

    attribute PortMode hostMode;

    attribute boolean server;

    attribute wstring path;

}; /* interface ISerialPort */

interface IParallelPort : $unknown
{
    readonly attribute unsigned long slot;

    attribute boolean enabled;

    attribute unsigned long IOBase;

    attribute unsigned long IRQ;

    attribute wstring path;

}; /* interface IParallelPort */

interface IMachineDebugger : $unknown
{
    attribute boolean singlestep;

    attribute boolean recompileUser;

    attribute boolean recompileSupervisor;

    attribute boolean PATMEnabled;

    attribute boolean CSAMEnabled;

    attribute boolean logEnabled;

    readonly attribute boolean HWVirtExEnabled;

    readonly attribute boolean HWVirtExNestedPagingEnabled;

    readonly attribute boolean HWVirtExVPIDEnabled;

    readonly attribute boolean PAEEnabled;

    attribute unsigned long virtualTimeRate;

    readonly attribute unsigned long long VM;

    void resetStats (
        in wstring pattern
    );

    void dumpStats (
        in wstring pattern
    );

    void getStats (
        in wstring pattern,
        in boolean withDescriptions,
        out wstring stats
    );

    void injectNMI();

}; /* interface IMachineDebugger */

interface IUSBController : $unknown
{
    attribute boolean enabled;

    attribute boolean enabledEhci;

    readonly attribute unsigned short USBStandard;

    readonly attribute IUSBDeviceFilter[] deviceFilters;

    void createDeviceFilter (
        in wstring name,
        [retval] out IUSBDeviceFilter filter
    );

    void insertDeviceFilter (
        in unsigned long position,
        in IUSBDeviceFilter filter
    );

    void removeDeviceFilter (
        in unsigned long position,
        [retval] out IUSBDeviceFilter filter
    );

}; /* interface IUSBController */

interface IUSBDevice : $unknown
{
    readonly attribute wstringUUID id;

    readonly attribute unsigned short vendorId;

    readonly attribute unsigned short productId;

    readonly attribute unsigned short revision;

    readonly attribute wstring manufacturer;

    readonly attribute wstring product;

    readonly attribute wstring serialNumber;

    readonly attribute wstring address;

    readonly attribute unsigned short port;

    readonly attribute unsigned short version;

    readonly attribute unsigned short portVersion;

    readonly attribute boolean remote;

}; /* interface IUSBDevice */

interface IUSBDeviceFilter : $unknown
{
    attribute wstring name;

    attribute boolean active;

    attribute wstring vendorId;

    attribute wstring productId;

    attribute wstring revision;

    attribute wstring manufacturer;

    attribute wstring product;

    attribute wstring serialNumber;

    attribute wstring port;

    attribute wstring remote;

    attribute unsigned long maskedInterfaces;

}; /* interface IUSBDeviceFilter */

interface IHostUSBDevice : IUSBDevice
{
    readonly attribute USBDeviceState state;

}; /* interface IHostUSBDevice */

interface IHostUSBDeviceFilter : IUSBDeviceFilter
{
    attribute USBDeviceFilterAction action;

}; /* interface IHostUSBDeviceFilter */

interface IAudioAdapter : $unknown
{
    attribute boolean enabled;

    attribute AudioControllerType audioController;

    attribute AudioDriverType audioDriver;

}; /* interface IAudioAdapter */

interface IVRDPServer : $unknown
{
    attribute boolean enabled;

    attribute wstring ports;

    attribute wstring netAddress;

    attribute VRDPAuthType authType;

    attribute unsigned long authTimeout;

    attribute boolean allowMultiConnection;

    attribute boolean reuseSingleConnection;

}; /* interface IVRDPServer */

interface ISharedFolder : $unknown
{
    readonly attribute wstring name;

    readonly attribute wstring hostPath;

    readonly attribute boolean accessible;

    readonly attribute boolean writable;

    readonly attribute wstring lastAccessError;

}; /* interface ISharedFolder */

interface IInternalSessionControl : $unknown
{
    void getPID (
        [retval] out unsigned long pid
    );

    void getRemoteConsole (
        [retval] out IConsole console
    );

    void assignMachine (
        in IMachine machine
    );

    void assignRemoteMachine (
        in IMachine machine,
        in IConsole console
    );

    void updateMachineState (
        in MachineState aMachineState
    );

    void uninitialize();

    void onNetworkAdapterChange (
        in INetworkAdapter networkAdapter,
        in boolean changeAdapter
    );

    void onSerialPortChange (
        in ISerialPort serialPort
    );

    void onParallelPortChange (
        in IParallelPort parallelPort
    );

    void onStorageControllerChange();

    void onMediumChange (
        in IMediumAttachment mediumAttachment,
        in boolean force
    );

    void onVRDPServerChange();

    void onUSBControllerChange();

    void onSharedFolderChange (
        in boolean global
    );

    void onUSBDeviceAttach (
        in IUSBDevice device,
        in IVirtualBoxErrorInfo error,
        in unsigned long maskedInterfaces
    );

    void onUSBDeviceDetach (
        in wstringUUID id,
        in IVirtualBoxErrorInfo error
    );

    void onShowWindow (
        in boolean check,
        out boolean canShow,
        out unsigned long long winId
    );

    void accessGuestProperty (
        in wstring name,
        in wstring value,
        in wstring flags,
        in boolean isSetter,
        out wstring retValue,
        out unsigned long long retTimestamp,
        out wstring retFlags
    );

    void enumerateGuestProperties (
        in wstring patterns,
        out wstring[] key,
        out wstring[] value,
        out unsigned long long[] timestamp,
        out wstring[] flags
    );

}; /* interface IInternalSessionControl */

interface ISession : $dispatched
{
    readonly attribute SessionState state;

    readonly attribute SessionType type;

    readonly attribute IMachine machine;

    readonly attribute IConsole console;

    void close();

}; /* interface ISession */

interface IStorageController : $unknown
{
    readonly attribute wstring name;

    readonly attribute unsigned long maxDevicesPerPortCount;

    readonly attribute unsigned long minPortCount;

    readonly attribute unsigned long maxPortCount;

    attribute unsigned long instance;

    attribute unsigned long portCount;

    readonly attribute StorageBus bus;

    attribute StorageControllerType controllerType;

    void GetIDEEmulationPort (
        in long devicePosition,
        [retval] out long portNumber
    );

    void SetIDEEmulationPort (
        in long devicePosition,
        in long portNumber
    );

}; /* interface IStorageController */

interface IManagedObjectRef : $unknown
{
    void getInterfaceName (
        [retval] out wstring return
    );

    void release();

}; /* interface IManagedObjectRef */

interface IWebsessionManager : $unknown
{
    void logon (
        in wstring username,
        in wstring password,
        [retval] out IVirtualBox return
    );

    void getSessionObject (
        in IVirtualBox refIVirtualBox,
        [retval] out ISession return
    );

    void logoff (
        in IVirtualBox refIVirtualBox
    );

}; /* interface IWebsessionManager */

interface IPerformanceMetric : $unknown
{
    readonly attribute wstring metricName;

    readonly attribute $unknown object;

    readonly attribute wstring description;

    readonly attribute unsigned long period;

    readonly attribute unsigned long count;

    readonly attribute wstring unit;

    readonly attribute long minimumValue;

    readonly attribute long maximumValue;

}; /* interface IPerformanceMetric */

interface IPerformanceCollector : $unknown
{
    readonly attribute wstring[] metricNames;

    void getMetrics (
        in wstring[] metricNames,
        in $unknown[] objects,
        [retval] out IPerformanceMetric[] metrics
    );

    void setupMetrics (
        in wstring[] metricNames,
        in $unknown[] objects,
        in unsigned long period,
        in unsigned long count,
        [retval] out IPerformanceMetric[] affectedMetrics
    );

    void enableMetrics (
        in wstring[] metricNames,
        in $unknown[] objects,
        [retval] out IPerformanceMetric[] affectedMetrics
    );

    void disableMetrics (
        in wstring[] metricNames,
        in $unknown[] objects,
        [retval] out IPerformanceMetric[] affectedMetrics
    );

    void queryMetricsData (
        in wstring[] metricNames,
        in $unknown[] objects,
        out wstring[] returnMetricNames,
        out $unknown[] returnObjects,
        out wstring[] returnUnits,
        out unsigned long[] returnScales,
        out unsigned long[] returnSequenceNumbers,
        out unsigned long[] returnDataIndices,
        out unsigned long[] returnDataLengths,
        [retval] out long[] returnData
    );

}; /* interface IPerformanceCollector */

---