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 TSBool
{
    TSBool_False = 0,
    TSBool_True = 1,
    TSBool_Default = 2,
};

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

enum MachineState
{
    MachineState_Null = 0,
    MachineState_PoweredOff = 1,
    MachineState_Saved = 2,
    MachineState_Aborted = 3,
    MachineState_Running = 4,
    MachineState_Paused = 5,
    MachineState_Stuck = 6,
    MachineState_Starting = 7,
    MachineState_Stopping = 8,
    MachineState_Saving = 9,
    MachineState_Restoring = 10,
    MachineState_Discarding = 11,
    MachineState_SettingUp = 12,
    MachineState_FirstOnline = 4,
    MachineState_LastOnline = 10,
    MachineState_FirstTransient = 7,
    MachineState_LastTransient = 12,
};

enum SessionState
{
    SessionState_Null = 0,
    SessionState_Closed = 1,
    SessionState_Open = 2,
    SessionState_Spawning = 3,
    SessionState_Closing = 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 DriveState
{
    DriveState_Null = 0,
    DriveState_NotMounted = 1,
    DriveState_ImageMounted = 2,
    DriveState_HostDriveCaptured = 3,
};

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

enum CIMOSType
{
    CIMOSType_CIMOS_Unknown = 0,
    CIMOSType_CIMOS_Other = 1,
    CIMOSType_CIMOS_MACOS = 2,
    CIMOSType_CIMOS_ATTUNIX = 3,
    CIMOSType_CIMOS_DGUX = 4,
    CIMOSType_CIMOS_DECNT = 5,
    CIMOSType_CIMOS_Tru64UNIX = 6,
    CIMOSType_CIMOS_OpenVMS = 7,
    CIMOSType_CIMOS_HPUX = 8,
    CIMOSType_CIMOS_AIX = 9,
    CIMOSType_CIMOS_MVS = 10,
    CIMOSType_CIMOS_OS400 = 11,
    CIMOSType_CIMOS_OS2 = 12,
    CIMOSType_CIMOS_JavaVM = 13,
    CIMOSType_CIMOS_MSDOS = 14,
    CIMOSType_CIMOS_WIN3x = 15,
    CIMOSType_CIMOS_WIN95 = 16,
    CIMOSType_CIMOS_WIN98 = 17,
    CIMOSType_CIMOS_WINNT = 18,
    CIMOSType_CIMOS_WINCE = 19,
    CIMOSType_CIMOS_NCR3000 = 20,
    CIMOSType_CIMOS_NetWare = 21,
    CIMOSType_CIMOS_OSF = 22,
    CIMOSType_CIMOS_DCOS = 23,
    CIMOSType_CIMOS_ReliantUNIX = 24,
    CIMOSType_CIMOS_SCOUnixWare = 25,
    CIMOSType_CIMOS_SCOOpenServer = 26,
    CIMOSType_CIMOS_Sequent = 27,
    CIMOSType_CIMOS_IRIX = 28,
    CIMOSType_CIMOS_Solaris = 29,
    CIMOSType_CIMOS_SunOS = 30,
    CIMOSType_CIMOS_U6000 = 31,
    CIMOSType_CIMOS_ASERIES = 32,
    CIMOSType_CIMOS_HPNonStopOS = 33,
    CIMOSType_CIMOS_HPNonStopOSS = 34,
    CIMOSType_CIMOS_BS2000 = 35,
    CIMOSType_CIMOS_LINUX = 36,
    CIMOSType_CIMOS_Lynx = 37,
    CIMOSType_CIMOS_XENIX = 38,
    CIMOSType_CIMOS_VM = 39,
    CIMOSType_CIMOS_InteractiveUNIX = 40,
    CIMOSType_CIMOS_BSDUNIX = 41,
    CIMOSType_CIMOS_FreeBSD = 42,
    CIMOSType_CIMOS_NetBSD = 43,
    CIMOSType_CIMOS_GNUHurd = 44,
    CIMOSType_CIMOS_OS9 = 45,
    CIMOSType_CIMOS_MACHKernel = 46,
    CIMOSType_CIMOS_Inferno = 47,
    CIMOSType_CIMOS_QNX = 48,
    CIMOSType_CIMOS_EPOC = 49,
    CIMOSType_CIMOS_IxWorks = 50,
    CIMOSType_CIMOS_VxWorks = 51,
    CIMOSType_CIMOS_MiNT = 52,
    CIMOSType_CIMOS_BeOS = 53,
    CIMOSType_CIMOS_HPMPE = 54,
    CIMOSType_CIMOS_NextStep = 55,
    CIMOSType_CIMOS_PalmPilot = 56,
    CIMOSType_CIMOS_Rhapsody = 57,
    CIMOSType_CIMOS_Windows2000 = 58,
    CIMOSType_CIMOS_Dedicated = 59,
    CIMOSType_CIMOS_OS390 = 60,
    CIMOSType_CIMOS_VSE = 61,
    CIMOSType_CIMOS_TPF = 62,
    CIMOSType_CIMOS_WindowsMe = 63,
    CIMOSType_CIMOS_CalderaOpenUNIX = 64,
    CIMOSType_CIMOS_OpenBSD = 65,
    CIMOSType_CIMOS_NotApplicable = 66,
    CIMOSType_CIMOS_WindowsXP = 67,
    CIMOSType_CIMOS_zOS = 68,
    CIMOSType_CIMOS_MicrosoftWindowsServer2003 = 69,
    CIMOSType_CIMOS_MicrosoftWindowsServer2003_64 = 70,
    CIMOSType_CIMOS_WindowsXP_64 = 71,
    CIMOSType_CIMOS_WindowsXPEmbedded = 72,
    CIMOSType_CIMOS_WindowsVista = 73,
    CIMOSType_CIMOS_WindowsVista_64 = 74,
    CIMOSType_CIMOS_WindowsEmbeddedforPointofService = 75,
    CIMOSType_CIMOS_MicrosoftWindowsServer2008 = 76,
    CIMOSType_CIMOS_MicrosoftWindowsServer2008_64 = 77,
    CIMOSType_CIMOS_FreeBSD_64 = 78,
    CIMOSType_CIMOS_RedHatEnterpriseLinux = 79,
    CIMOSType_CIMOS_RedHatEnterpriseLinux_64 = 80,
    CIMOSType_CIMOS_Solaris_64 = 81,
    CIMOSType_CIMOS_SUSE = 82,
    CIMOSType_CIMOS_SUSE_64 = 83,
    CIMOSType_CIMOS_SLES = 84,
    CIMOSType_CIMOS_SLES_64 = 85,
    CIMOSType_CIMOS_NovellOES = 86,
    CIMOSType_CIMOS_NovellLinuxDesktop = 87,
    CIMOSType_CIMOS_SunJavaDesktopSystem = 88,
    CIMOSType_CIMOS_Mandriva = 89,
    CIMOSType_CIMOS_Mandriva_64 = 90,
    CIMOSType_CIMOS_TurboLinux = 91,
    CIMOSType_CIMOS_TurboLinux_64 = 92,
    CIMOSType_CIMOS_Ubuntu = 93,
    CIMOSType_CIMOS_Ubuntu_64 = 94,
    CIMOSType_CIMOS_Debian = 95,
    CIMOSType_CIMOS_Debian_64 = 96,
    CIMOSType_CIMOS_Linux_2_4_x = 97,
    CIMOSType_CIMOS_Linux_2_4_x_64 = 98,
    CIMOSType_CIMOS_Linux_2_6_x = 99,
    CIMOSType_CIMOS_Linux_2_6_x_64 = 100,
    CIMOSType_CIMOS_Linux_64 = 101,
    CIMOSType_CIMOS_Other_64 = 102,
};

enum OVFResourceType
{
    OVFResourceType_Other = 1,
    OVFResourceType_ComputerSystem = 2,
    OVFResourceType_Processor = 3,
    OVFResourceType_Memory = 4,
    OVFResourceType_IDEController = 5,
    OVFResourceType_ParallelSCSIHBA = 6,
    OVFResourceType_FCHBA = 7,
    OVFResourceType_iSCSIHBA = 8,
    OVFResourceType_IBHCA = 9,
    OVFResourceType_EthernetAdapter = 10,
    OVFResourceType_OtherNetworkAdapter = 11,
    OVFResourceType_IOSlot = 12,
    OVFResourceType_IODevice = 13,
    OVFResourceType_FloppyDrive = 14,
    OVFResourceType_CDDrive = 15,
    OVFResourceType_DVDDrive = 16,
    OVFResourceType_HardDisk = 17,
    OVFResourceType_OtherStorageDevice = 20,
    OVFResourceType_USBController = 23,
    OVFResourceType_SoundCard = 35,
};

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 MediaState
{
    MediaState_NotCreated = 0,
    MediaState_Created = 1,
    MediaState_LockedRead = 2,
    MediaState_LockedWrite = 3,
    MediaState_Inaccessible = 4,
    MediaState_Creating = 5,
    MediaState_Deleting = 6,
};

enum HardDiskType
{
    HardDiskType_Normal = 0,
    HardDiskType_Immutable = 1,
    HardDiskType_Writethrough = 2,
};

enum HardDiskVariant
{
    HardDiskVariant_Standard = 0,
    HardDiskVariant_VmdkSplit2G = 0x01,
    HardDiskVariant_VmdkStreamOptimized = 0x04,
    HardDiskVariant_VmdkESX = 0x08,
    HardDiskVariant_Fixed = 0x10000,
    HardDiskVariant_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 HardDiskFormatCapabilities
{
    HardDiskFormatCapabilities_Uuid = 0x01,
    HardDiskFormatCapabilities_CreateFixed = 0x02,
    HardDiskFormatCapabilities_CreateDynamic = 0x04,
    HardDiskFormatCapabilities_CreateSplit2G = 0x08,
    HardDiskFormatCapabilities_Differencing = 0x10,
    HardDiskFormatCapabilities_Asynchronous = 0x20,
    HardDiskFormatCapabilities_File = 0x40,
    HardDiskFormatCapabilities_Properties = 0x80,
    HardDiskFormatCapabilities_CapabilityMask = 0xFF,
};

enum MouseButtonState
{
    MouseButtonState_LeftButton = 0x01,
    MouseButtonState_RightButton = 0x02,
    MouseButtonState_MiddleButton = 0x04,
    MouseButtonState_WheelUp = 0x08,
    MouseButtonState_WheelDown = 0x10,
    MouseButtonState_MouseStateMask = 0x1F,
};

enum FramebufferAccelerationOperation
{
    FramebufferAccelerationOperation_SolidFillAcceleration = 1,
    FramebufferAccelerationOperation_ScreenCopyAcceleration = 2,
};

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,
};

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

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,
};

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

interface IVirtualBoxErrorInfo : $errorinfo
{
    readonly attribute result resultCode;

    readonly attribute uuid interfaceID;

    readonly attribute wstring component;

    readonly attribute wstring text;

    readonly attribute IVirtualBoxErrorInfo next;

}; /* interface IVirtualBoxErrorInfo */

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

    void onMachineDataChange (
        in uuid machineId
    );

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

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

    void onMediaRegistered (
        in uuid mediaId,
        in DeviceType mediaType,
        in boolean registered
    );

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

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

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

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

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

    void onGuestPropertyChange (
        in uuid 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 wstring settingsFileVersion;

    readonly attribute wstring settingsFormatVersion;

    readonly attribute IHost host;

    readonly attribute ISystemProperties systemProperties;

    readonly attribute IMachine[] machines;

    readonly attribute IHardDisk[] hardDisks;

    readonly attribute IDVDImage[] DVDImages;

    readonly attribute IFloppyImage[] 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 uuid id,
        [retval] out IMachine machine
    );

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

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

    void registerMachine (
        in IMachine machine
    );

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

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

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

    void createAppliance (
        [retval] out IAppliance appliance
    );

    void createHardDisk (
        in wstring format,
        in wstring location,
        [retval] out IHardDisk hardDisk
    );

    void openHardDisk (
        in wstring location,
        in AccessMode accessMode,
        [retval] out IHardDisk hardDisk
    );

    void getHardDisk (
        in uuid id,
        [retval] out IHardDisk hardDisk
    );

    void findHardDisk (
        in wstring location,
        [retval] out IHardDisk hardDisk
    );

    void openDVDImage (
        in wstring location,
        in uuid id,
        [retval] out IDVDImage image
    );

    void getDVDImage (
        in uuid id,
        [retval] out IDVDImage image
    );

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

    void openFloppyImage (
        in wstring location,
        in uuid id,
        [retval] out IFloppyImage image
    );

    void getFloppyImage (
        in uuid id,
        [retval] out IFloppyImage image
    );

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

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

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

    void removeSharedFolder (
        in wstring name
    );

    void getNextExtraDataKey (
        in wstring key,
        out wstring nextKey,
        out wstring nextValue
    );

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

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

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

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

    void openExistingSession (
        in ISession session,
        in uuid 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 saveSettings();

    void saveSettingsWithBackup (
        [retval] out wstring bakFileName
    );

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

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

    void removeDHCPServer (
        in IDHCPServer server
    );

}; /* interface IVirtualBox */

interface IAppliance : $unknown
{
    readonly attribute wstring path;

    readonly attribute wstring[] disks;

    readonly attribute IVirtualSystemDescription[] virtualSystemDescriptions;

    void read (
        in wstring file
    );

    void interpret();

    void importMachines (
        [retval] out IProgress aProgress
    );

    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 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 uuid id
    );

    void detachUSBDevice (
        in uuid 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 progress,
        out wstring stateFilePath,
        out IProgress serverProgress
    );

    void endTakingSnapshot (
        in boolean success
    );

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

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

    void discardCurrentSnapshotAndState (
        in IConsole initiator,
        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();

}; /* 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 uuid id;

    attribute wstring OSTypeId;

    attribute wstring HardwareVersion;

    attribute unsigned long CPUCount;

    attribute unsigned long memorySize;

    attribute unsigned long memoryBalloonSize;

    attribute unsigned long statisticsUpdateInterval;

    attribute unsigned long VRAMSize;

    attribute boolean accelerate3DEnabled;

    attribute unsigned long monitorCount;

    readonly attribute IBIOSSettings BIOSSettings;

    attribute TSBool HWVirtExEnabled;

    attribute boolean HWVirtExNestedPagingEnabled;

    attribute boolean HWVirtExVPIDEnabled;

    attribute boolean PAEEnabled;

    attribute wstring snapshotFolder;

    readonly attribute IVRDPServer VRDPServer;

    readonly attribute IHardDiskAttachment[] hardDiskAttachments;

    readonly attribute IDVDDrive DVDDrive;

    readonly attribute IFloppyDrive floppyDrive;

    readonly attribute IUSBController USBController;

    readonly attribute IAudioAdapter audioAdapter;

    readonly attribute IStorageController[] storageControllers;

    readonly attribute wstring settingsFilePath;

    readonly attribute wstring settingsFileVersion;

    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;

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

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

    void attachHardDisk (
        in uuid id,
        in wstring name,
        in long controllerPort,
        in long device
    );

    void getHardDisk (
        in wstring name,
        in long controllerPort,
        in long device,
        [retval] out IHardDisk hardDisk
    );

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

    void getHardDiskAttachmentsOfController (
        in wstring name,
        [retval] out IHardDiskAttachment[] hardDiskAttachments
    );

    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 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 getNextExtraDataKey (
        in wstring key,
        out wstring nextKey,
        out wstring nextValue
    );

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

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

    void saveSettings();

    void saveSettingsWithBackup (
        [retval] out wstring bakFileName
    );

    void discardSettings();

    void deleteSettings();

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

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

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

    void setCurrentSnapshot (
        in uuid 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
    );

}; /* 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 onDVDDriveChange();

    void onFloppyDriveChange();

    void onNetworkAdapterChange (
        in INetworkAdapter networkAdapter
    );

    void onSerialPortChange (
        in ISerialPort serialPort
    );

    void onParallelPortChange (
        in IParallelPort parallelPort
    );

    void onStorageControllerChange();

    void onVRDPServerChange();

    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 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();

    void powerDownAsync (
        [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 discardSavedState();

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

    void attachUSBDevice (
        in uuid id
    );

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

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

    void findUSBDeviceById (
        in uuid 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 discardSnapshot (
        in uuid id,
        [retval] out IProgress progress
    );

    void discardCurrentState (
        [retval] out IProgress progress
    );

    void discardCurrentSnapshotAndState (
        [retval] out IProgress progress
    );

    void registerCallback (
        in IConsoleCallback callback
    );

    void unregisterCallback (
        in IConsoleCallback callback
    );

}; /* interface IConsole */

interface IHostDVDDrive : $unknown
{
    readonly attribute wstring name;

    readonly attribute wstring description;

    readonly attribute wstring udi;

}; /* interface IHostDVDDrive */

interface IHostFloppyDrive : $unknown
{
    readonly attribute wstring name;

    readonly attribute wstring description;

    readonly attribute wstring udi;

}; /* interface IHostFloppyDrive */

interface IHostNetworkInterface : $unknown
{
    readonly attribute wstring name;

    readonly attribute uuid 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 IHostDVDDrive[] DVDDrives;

    readonly attribute IHostFloppyDrive[] 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;

    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 createUSBDeviceFilter (
        in wstring name,
        [retval] out IHostUSBDeviceFilter filter
    );

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

    void removeUSBDeviceFilter (
        in unsigned long position,
        [retval] out IHostUSBDeviceFilter filter
    );

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

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

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

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

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

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

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

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

    void removeHostOnlyNetworkInterface (
        in uuid id,
        out IHostNetworkInterface hostInterface,
        [retval] out IProgress progress
    );

}; /* 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 IHardDiskFormat[] hardDiskFormats;

    attribute wstring defaultHardDiskFormat;

    attribute wstring remoteDisplayAuthLibrary;

    attribute wstring webServiceAuthLibrary;

    attribute boolean HWVirtExEnabled;

    attribute unsigned long LogHistoryCount;

}; /* 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,
        out unsigned long statVal
    );

}; /* interface IGuest */

interface IProgress : $unknown
{
    readonly attribute uuid 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 result resultCode;

    readonly attribute IVirtualBoxErrorInfo errorInfo;

    readonly attribute unsigned long operationCount;

    readonly attribute unsigned long operation;

    readonly attribute wstring operationDescription;

    readonly attribute unsigned long operationPercent;

    void waitForCompletion (
        in long timeout
    );

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

    void cancel();

}; /* interface IProgress */

interface ISnapshot : $unknown
{
    readonly attribute uuid 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 IMedium : $unknown
{
    readonly attribute uuid id;

    attribute wstring description;

    readonly attribute MediaState state;

    attribute wstring location;

    readonly attribute wstring name;

    readonly attribute unsigned long long size;

    readonly attribute wstring lastAccessError;

    readonly attribute uuid[] machineIds;

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

    void lockRead (
        [retval] out MediaState state
    );

    void unlockRead (
        [retval] out MediaState state
    );

    void lockWrite (
        [retval] out MediaState state
    );

    void unlockWrite (
        [retval] out MediaState state
    );

    void close();

}; /* interface IMedium */

interface IHardDiskAttachment : $unknown
{
    readonly attribute IHardDisk hardDisk;

    readonly attribute wstring controller;

    readonly attribute long port;

    readonly attribute long device;

}; /* interface IHardDiskAttachment */

interface IHardDisk : IMedium
{
    readonly attribute wstring format;

    attribute HardDiskType type;

    readonly attribute IHardDisk parent;

    readonly attribute IHardDisk[] children;

    readonly attribute IHardDisk root;

    readonly attribute boolean readOnly;

    readonly attribute unsigned long long logicalSize;

    attribute boolean autoReset;

    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 HardDiskVariant variant,
        [retval] out IProgress progress
    );

    void deleteStorage (
        [retval] out IProgress progress
    );

    void createDiffStorage (
        in IHardDisk target,
        in HardDiskVariant variant,
        [retval] out IProgress progress
    );

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

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

    void compact (
        [retval] out IProgress progress
    );

    void reset (
        [retval] out IProgress progress
    );

}; /* interface IHardDisk */

interface IHardDiskFormat : $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 IHardDiskFormat */

interface IFloppyImage : IMedium
{
}; /* interface IFloppyImage */

interface IDVDImage : IMedium
{
}; /* interface IDVDImage */

interface IDVDDrive : $unknown
{
    readonly attribute DriveState state;

    attribute boolean passthrough;

    void mountImage (
        in uuid imageId
    );

    void captureHostDrive (
        in IHostDVDDrive drive
    );

    void unmount();

    void getImage (
        [retval] out IDVDImage image
    );

    void getHostDrive (
        [retval] out IHostDVDDrive drive
    );

}; /* interface IDVDDrive */

interface IFloppyDrive : $unknown
{
    attribute boolean enabled;

    readonly attribute DriveState state;

    void mountImage (
        in uuid imageId
    );

    void captureHostDrive (
        in IHostFloppyDrive drive
    );

    void unmount();

    void getImage (
        [retval] out IFloppyImage image
    );

    void getHostDrive (
        [retval] out IHostFloppyDrive drive
    );

}; /* interface IFloppyDrive */

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 buttonState
    );

    void putMouseEventAbsolute (
        in long x,
        in long y,
        in long dz,
        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,
        [retval] out boolean finished
    );

    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 operationSupported (
        in FramebufferAccelerationOperation operation,
        [retval] out boolean supported
    );

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

    void solidFill (
        in unsigned long x,
        in unsigned long y,
        in unsigned long width,
        in unsigned long height,
        in unsigned long color,
        [retval] out boolean handled
    );

    void copyScreenBits (
        in unsigned long xDst,
        in unsigned long yDst,
        in unsigned long xSrc,
        in unsigned long ySrc,
        in unsigned long width,
        in unsigned long height,
        [retval] out boolean handled
    );

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

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

}; /* 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 setupInternalFramebuffer (
        in unsigned long depth
    );

    void lockFramebuffer (
        [retval] out octetPtr address
    );

    void unlockFramebuffer();

    void registerExternalFramebuffer (
        in IFramebuffer framebuffer
    );

    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 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();

}; /* 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 uuid 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 unsigned long port;

    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 onDVDDriveChange();

    void onFloppyDriveChange();

    void onNetworkAdapterChange (
        in INetworkAdapter networkAdapter
    );

    void onSerialPortChange (
        in ISerialPort serialPort
    );

    void onParallelPortChange (
        in IParallelPort parallelPort
    );

    void onStorageControllerChange();

    void onVRDPServerChange();

    void onUSBControllerChange();

    void onSharedFolderChange (
        in boolean global
    );

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

    void onUSBDeviceDetach (
        in uuid 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 */

---