VirtualBox

Changeset 34416 in vbox for trunk/src/VBox


Ignore:
Timestamp:
Nov 26, 2010 5:17:12 PM (14 years ago)
Author:
vboxsync
Message:

Main/VirtualBoxClient: new client-side singleton interface for convenient monitoring of VBoxSVC liveness, plus a big whitespace cleanup of the xidl file

Location:
trunk/src/VBox/Main
Files:
3 edited
1 copied

Legend:

Unmodified
Added
Removed

  • trunk/src/VBox/Main/Makefile.kmk

    r34397 r34416  
    630630        VirtualBoxBase.cpp \
    631631        VirtualBoxErrorInfoImpl.cpp \
     632        VirtualBoxClientImpl.cpp \
    632633        ProgressImpl.cpp \
    633634        SharedFolderImpl.cpp \

  • trunk/src/VBox/Main/idl/VirtualBox.xidl

    r34398 r34416  
    129129#ifndef NS_IMPL_THREADSAFE_ISUPPORTS1_CI
    130130# define NS_IMPL_THREADSAFE_ISUPPORTS1_CI(_class, _interface)                 \
    131    NS_IMPL_THREADSAFE_ADDREF(_class)                                          \
    132    NS_IMPL_THREADSAFE_RELEASE(_class)                                         \
    133    NS_IMPL_THREADSAFE_QUERY_INTERFACE1_CI(_class, _interface)                 \
    134    NS_IMPL_CI_INTERFACE_GETTER1(_class, _interface)
     131  NS_IMPL_THREADSAFE_ADDREF(_class)                                           \
     132  NS_IMPL_THREADSAFE_RELEASE(_class)                                          \
     133  NS_IMPL_THREADSAFE_QUERY_INTERFACE1_CI(_class, _interface)                  \
     134  NS_IMPL_CI_INTERFACE_GETTER1(_class, _interface)
    135135#endif
    136136
    137137#ifndef NS_IMPL_THREADSAFE_ISUPPORTS2_CI
    138138# define NS_IMPL_THREADSAFE_ISUPPORTS2_CI(_class, _i1, _i2)                   \
    139    NS_IMPL_THREADSAFE_ADDREF(_class)                                          \
    140    NS_IMPL_THREADSAFE_RELEASE(_class)                                         \
    141    NS_IMPL_THREADSAFE_QUERY_INTERFACE2_CI(_class, _i1, _i2)                   \
    142    NS_IMPL_CI_INTERFACE_GETTER2(_class, _i1, _i2)
     139  NS_IMPL_THREADSAFE_ADDREF(_class)                                           \
     140  NS_IMPL_THREADSAFE_RELEASE(_class)                                          \
     141  NS_IMPL_THREADSAFE_QUERY_INTERFACE2_CI(_class, _i1, _i2)                    \
     142  NS_IMPL_CI_INTERFACE_GETTER2(_class, _i1, _i2)
    143143#endif
    144144
    145145#ifndef NS_IMPL_THREADSAFE_ISUPPORTS3_CI
    146146# define NS_IMPL_THREADSAFE_ISUPPORTS3_CI(_class, _i1, _i2, _i3)              \
    147    NS_IMPL_THREADSAFE_ADDREF(_class)                                          \
    148    NS_IMPL_THREADSAFE_RELEASE(_class)                                         \
    149    NS_IMPL_THREADSAFE_QUERY_INTERFACE3_CI(_class, _i1, _i2, _i3)              \
    150    NS_IMPL_CI_INTERFACE_GETTER3(_class, _i1, _i2, _i3)
     147  NS_IMPL_THREADSAFE_ADDREF(_class)                                           \
     148  NS_IMPL_THREADSAFE_RELEASE(_class)                                          \
     149  NS_IMPL_THREADSAFE_QUERY_INTERFACE3_CI(_class, _i1, _i2, _i3)               \
     150  NS_IMPL_CI_INTERFACE_GETTER3(_class, _i1, _i2, _i3)
    151151#endif
    152152
    153153#ifndef NS_IMPL_THREADSAFE_ISUPPORTS4_CI
    154154# define NS_IMPL_THREADSAFE_ISUPPORTS4_CI(_class, _i1, _i2, _i3, _i4)         \
    155    NS_IMPL_THREADSAFE_ADDREF(_class)                                          \
    156    NS_IMPL_THREADSAFE_RELEASE(_class)                                         \
    157    NS_IMPL_THREADSAFE_QUERY_INTERFACE4_CI(_class, _i1, _i2, _i3, _i4)         \
    158    NS_IMPL_CI_INTERFACE_GETTER4(_class, _i1, _i2, _i3, _i4)
     155  NS_IMPL_THREADSAFE_ADDREF(_class)                                           \
     156  NS_IMPL_THREADSAFE_RELEASE(_class)                                          \
     157  NS_IMPL_THREADSAFE_QUERY_INTERFACE4_CI(_class, _i1, _i2, _i3, _i4)          \
     158  NS_IMPL_CI_INTERFACE_GETTER4(_class, _i1, _i2, _i3, _i4)
    159159#endif
    160160
    161161#ifndef NS_IMPL_QUERY_INTERFACE1_AMBIGUOUS_CI
    162162# define NS_IMPL_QUERY_INTERFACE1_AMBIGUOUS_CI(_class, _i1, _ic1)             \
    163    NS_INTERFACE_MAP_BEGIN(_class)                                             \
     163  NS_INTERFACE_MAP_BEGIN(_class)                                              \
    164164    NS_INTERFACE_MAP_ENTRY_AMBIGUOUS(_i1, _ic1)                               \
    165165    NS_INTERFACE_MAP_ENTRY_AMBIGUOUS(nsISupports, _ic1)                       \
    166166    NS_IMPL_QUERY_CLASSINFO(_class)                                           \
    167    NS_INTERFACE_MAP_END
     167  NS_INTERFACE_MAP_END
    168168#endif
    169169
    … …  
    171171# define NS_IMPL_QUERY_INTERFACE2_AMBIGUOUS_CI(_class, _i1, _ic1,             \
    172172                                               _i2, _ic2)                     \
    173    NS_INTERFACE_MAP_BEGIN(_class)                                             \
     173  NS_INTERFACE_MAP_BEGIN(_class)                                              \
    174174    NS_INTERFACE_MAP_ENTRY_AMBIGUOUS(_i1, _ic1)                               \
    175175    NS_INTERFACE_MAP_ENTRY_AMBIGUOUS(_i2, _ic2)                               \
    176176    NS_INTERFACE_MAP_ENTRY_AMBIGUOUS(nsISupports, _ic1)                       \
    177177    NS_IMPL_QUERY_CLASSINFO(_class)                                           \
    178    NS_INTERFACE_MAP_END
     178  NS_INTERFACE_MAP_END
    179179#endif
    180180
    … …  
    182182# define NS_IMPL_QUERY_INTERFACE3_AMBIGUOUS_CI(_class, _i1, _ic1,             \
    183183                                               _i2, _ic2, _i3, _ic3)          \
    184    NS_INTERFACE_MAP_BEGIN(_class)                                             \
     184  NS_INTERFACE_MAP_BEGIN(_class)                                              \
    185185    NS_INTERFACE_MAP_ENTRY_AMBIGUOUS(_i1, _ic1)                               \
    186186    NS_INTERFACE_MAP_ENTRY_AMBIGUOUS(_i2, _ic2)                               \
    … …  
    188188    NS_INTERFACE_MAP_ENTRY_AMBIGUOUS(nsISupports, _ic1)                       \
    189189    NS_IMPL_QUERY_CLASSINFO(_class)                                           \
    190    NS_INTERFACE_MAP_END
     190  NS_INTERFACE_MAP_END
    191191#endif
    192192
    … …  
    197197#ifndef NS_IMPL_THREADSAFE_ISUPPORTS1_AMBIGUOUS_CI
    198198# define NS_IMPL_THREADSAFE_ISUPPORTS1_AMBIGUOUS_CI(_class, _i1, _ic1)        \
    199    NS_IMPL_THREADSAFE_ADDREF(_class)                                          \
    200    NS_IMPL_THREADSAFE_RELEASE(_class)                                         \
    201    NS_IMPL_THREADSAFE_QUERY_INTERFACE1_AMBIGUOUS_CI(_class, _i1, _ic1)        \
    202    NS_IMPL_CI_INTERFACE_GETTER1(_class, _i1)
     199  NS_IMPL_THREADSAFE_ADDREF(_class)                                           \
     200  NS_IMPL_THREADSAFE_RELEASE(_class)                                          \
     201  NS_IMPL_THREADSAFE_QUERY_INTERFACE1_AMBIGUOUS_CI(_class, _i1, _ic1)         \
     202  NS_IMPL_CI_INTERFACE_GETTER1(_class, _i1)
    203203#endif
    204204
    … …  
    206206# define NS_IMPL_THREADSAFE_ISUPPORTS2_AMBIGUOUS_CI(_class, _i1, _ic1,        \
    207207                                                     _i2, _ic2)               \
    208    NS_IMPL_THREADSAFE_ADDREF(_class)                                          \
    209    NS_IMPL_THREADSAFE_RELEASE(_class)                                         \
    210    NS_IMPL_THREADSAFE_QUERY_INTERFACE2_AMBIGUOUS_CI(_class, _i1, _ic1,        \
    211                                                     _i2, _ic2)                \
    212    NS_IMPL_CI_INTERFACE_GETTER2(_class, _i1, _i2)
     208  NS_IMPL_THREADSAFE_ADDREF(_class)                                           \
     209  NS_IMPL_THREADSAFE_RELEASE(_class)                                          \
     210  NS_IMPL_THREADSAFE_QUERY_INTERFACE2_AMBIGUOUS_CI(_class, _i1, _ic1,         \
     211                                                   _i2, _ic2)                 \
     212  NS_IMPL_CI_INTERFACE_GETTER2(_class, _i1, _i2)
    213213#endif
    214214
    … …  
    216216# define NS_IMPL_THREADSAFE_ISUPPORTS3_AMBIGUOUS_CI(_class, _i1, _ic1,        \
    217217                                                     _i2, _ic2, _i3, _ic3)    \
    218    NS_IMPL_THREADSAFE_ADDREF(_class)                                          \
    219    NS_IMPL_THREADSAFE_RELEASE(_class)                                         \
    220    NS_IMPL_THREADSAFE_QUERY_INTERFACE3_AMBIGUOUS_CI(_class, _i1, _ic1,        \
    221                                                     _i2, _ic2, _i3, _ic3)     \
    222    NS_IMPL_CI_INTERFACE_GETTER3(_class, _i1, _i2, _i3)
     218  NS_IMPL_THREADSAFE_ADDREF(_class)                                           \
     219  NS_IMPL_THREADSAFE_RELEASE(_class)                                          \
     220  NS_IMPL_THREADSAFE_QUERY_INTERFACE3_AMBIGUOUS_CI(_class, _i1, _ic1,         \
     221                                                   _i2, _ic2, _i3, _ic3)      \
     222  NS_IMPL_CI_INTERFACE_GETTER3(_class, _i1, _i2, _i3)
    223223#endif
    224224
    … …  
    227227
    228228<library
    229    name="VirtualBox"
    230    uuid="46137EEC-703B-4fe5-AFD4-7C9BBBBA0259"
    231    version="1.3"
    232    desc="VirtualBox Type Library"
    233    appUuid="819B4D85-9CEE-493C-B6FC-64FFE759B3C9"
    234    supportsErrorInfo="yes"
     229  name="VirtualBox"
     230  uuid="46137EEC-703B-4fe5-AFD4-7C9BBBBA0259"
     231  version="1.3"
     232  desc="VirtualBox Type Library"
     233  appUuid="819B4D85-9CEE-493C-B6FC-64FFE759B3C9"
     234  supportsErrorInfo="yes"
    235235>
    236236
    … …  
    385385  -->
    386386
    387   <enum name="SettingsVersion"
    388         uuid="52bd6f5f-1adb-4493-975d-581a9c4b803f"
     387  <enum
     388    name="SettingsVersion"
     389    uuid="52bd6f5f-1adb-4493-975d-581a9c4b803f"
    389390    >
    390     <desc>Settings version of VirtualBox settings files. This is written to
    391           the "version" attribute of the root "VirtualBox" element in the settings
    392           file XML and indicates which VirtualBox version wrote the file.
     391    <desc>
     392      Settings version of VirtualBox settings files. This is written to
     393      the "version" attribute of the root "VirtualBox" element in the settings
     394      file XML and indicates which VirtualBox version wrote the file.
    393395    </desc>
    394396
    … …  
    411413      <desc>Settings version "1.3", written by VirtualBox 2.0.12.</desc>
    412414      <!--
    413             Machine XML: Capitalization of Uart, Lpt elements and many attributes changed.
     415          Machine XML: Capitalization of Uart, Lpt elements and many attributes changed.
    414416      -->
    415417    </const>
    … …  
    423425    <const name="v1_5"     value="7">
    424426      <desc>Intermediate settings version, understood by VirtualBox 2.1.x.</desc>
    425       <!-- 2008-09-04: 2.0.0 released
    426            2008-11-20: settings version 1.5 introduced
    427            2008-12-17: 2.1.0 released
    428            Machine changes:
    429               guest OS identifiers changed;
    430               Machine/Hardware/Display/MonitorCount renamed to monitorCount;
    431               Machine/Hardware/Display/Accelerate3D renamed to accelerate3D;
    432               Machine/Hardware/CPU/CPUCount/@count changed to CPU/@count
     427      <!--
     428          2008-09-04: 2.0.0 released
     429          2008-11-20: settings version 1.5 introduced
     430          2008-12-17: 2.1.0 released
     431          Machine changes:
     432            guest OS identifiers changed;
     433            Machine/Hardware/Display/MonitorCount renamed to monitorCount;
     434            Machine/Hardware/Display/Accelerate3D renamed to accelerate3D;
     435            Machine/Hardware/CPU/CPUCount/@count changed to CPU/@count
    433436      -->
    434437    </const>
    435438    <const name="v1_6"     value="8">
    436439      <desc>Settings version "1.6", written by VirtualBox 2.1.4 (at least).</desc>
    437       <!-- 2008-12-17: 2.1.0 released
    438            2008-12-19: settings version 1.6 introduced (is in 2.1 branch)
    439            2009-04-08: 2.2.0 released
    440            Machine changes: remove all Machine/Hardware/Network/Adapter/HostInterface[@TAPSetup or @TAPTerminate]/ attributes (done)
     440      <!--
     441          2008-12-17: 2.1.0 released
     442          2008-12-19: settings version 1.6 introduced (is in 2.1 branch)
     443          2009-04-08: 2.2.0 released
     444          Machine changes: remove all Machine/Hardware/Network/Adapter/HostInterface[@TAPSetup or @TAPTerminate]/ attributes (done)
    441445      -->
    442446    </const>
    443447    <const name="v1_7"     value="9">
    444448      <desc>Settings version "1.7", written by VirtualBox 2.2.x and 3.0.x.</desc>
    445       <!-- 2008-12-17: 2.1.0 released
    446            2009-03-11: settings version 1.7 introduced (is in 2.2 branch)
    447            2009-04-08: 2.2.0 released
    448            VirtualBox.xml additions: NetserviceRegistry with DHCPServers (done)
    449            Machine changes: HardDiskAttachments is now StorageControllers (done)
     449      <!--
     450          2008-12-17: 2.1.0 released
     451          2009-03-11: settings version 1.7 introduced (is in 2.2 branch)
     452          2009-04-08: 2.2.0 released
     453          VirtualBox.xml additions: NetserviceRegistry with DHCPServers (done)
     454          Machine changes: HardDiskAttachments is now StorageControllers (done)
    450455      -->
    451456    </const>
    452457    <const name="v1_8"     value="10">
    453458      <desc>Intermediate settings version "1.8", understood by VirtualBox 3.1.x.</desc>
    454       <!-- Machine additions: Display/@accelerate2DVideo (done)
     459      <!--
     460          Machine additions: Display/@accelerate2DVideo (done)
    455461      -->
    456462    </const>
    457463    <const name="v1_9"     value="11">
    458464      <desc>Settings version "1.9", written by VirtualBox 3.1.x.</desc>
    459       <!-- The big storage controller / DVD / Floppy rework (done)
    460            -->
     465      <!--
     466          The big storage controller / DVD / Floppy rework (done)
     467      -->
    461468    </const>
    462469    <const name="v1_10"     value="12">
    463470      <desc>Settings version "1.10", written by VirtualBox 3.2.x.</desc>
    464       <!-- Machine changes: RTC localOrUTC (done)
    465            CPU hot-plug support
    466            -->
     471      <!--
     472          Machine changes: RTC localOrUTC (done)
     473          CPU hot-plug support
     474      -->
    467475    </const>
    468476    <const name="v1_11"     value="13">
    469477      <desc>Settings version "1.11", written by VirtualBox 4.0.x.</desc>
    470       <!-- Machine changes: HD Audio controller, per-machine disk registries,
    471            /@format attribute for DVD and floppy images.
    472            -->
     478      <!--
     479          Machine changes: HD Audio controller, per-machine disk registries,
     480          /@format attribute for DVD and floppy images.
     481      -->
    473482    </const>
    474483    <const name="Future"     value="99999">
    … …  
    478487
    479488  <enum
    480        name="AccessMode"
    481        uuid="1da0007c-ddf7-4be8-bcac-d84a1558785f"
    482        >
    483       <desc>
    484           Access mode for opening files.
    485       </desc>
    486 
    487       <const name="ReadOnly"   value="1"/>
    488       <const name="ReadWrite"  value="2"/>
     489    name="AccessMode"
     490    uuid="1da0007c-ddf7-4be8-bcac-d84a1558785f"
     491    >
     492    <desc>
     493      Access mode for opening files.
     494    </desc>
     495
     496    <const name="ReadOnly"   value="1"/>
     497    <const name="ReadWrite"  value="2"/>
    489498  </enum>
    490499
    … …  
    492501    name="MachineState"
    493502    uuid="ec6c6a9e-113d-4ff4-b44f-0b69f21c97fe"
    494   >
     503    >
    495504    <desc>
    496505      Virtual machine execution state.
    … …  
    796805    name="SessionState"
    797806    uuid="cf2700c0-ea4b-47ae-9725-7810114b94d8"
    798   >
     807    >
    799808    <desc>
    800809      Session state. This enumeration represents possible values of
    … …  
    845854    name="CPUPropertyType"
    846855    uuid="24d356a6-2f45-4abd-b977-1cbe9c4701f5"
    847   >
     856    >
    848857    <desc>
    849858      Virtual CPU property type. This enumeration represents possible values of the
    … …  
    872881    name="HWVirtExPropertyType"
    873882    uuid="ce81dfdd-d2b8-4a90-bbea-40ee8b7ffcee"
    874   >
     883    >
    875884    <desc>
    876885      Hardware virtualization property type. This enumeration represents possible values
    … …  
    918927
    919928  <enum
    920    name="FaultToleranceState"
    921    uuid="5124f7ec-6b67-493c-9dee-ee45a44114e1"
    922   >
     929    name="FaultToleranceState"
     930    uuid="5124f7ec-6b67-493c-9dee-ee45a44114e1"
     931    >
    923932    <desc>
    924933      Used with <link to="IMachine::faultToleranceState" />.
    … …  
    936945
    937946  <enum
    938    name="LockType"
    939    uuid="138b53f8-db4b-47c5-b32b-4ef52f769413"
    940   >
     947    name="LockType"
     948    uuid="138b53f8-db4b-47c5-b32b-4ef52f769413"
     949    >
    941950    <desc>
    942951      Used with <link to="IMachine::lockMachine" />.
    … …  
    953962    name="SessionType"
    954963    uuid="A13C02CB-0C2C-421E-8317-AC0E8AAA153A"
    955   >
     964    >
    956965    <desc>
    957966      Session type. This enumeration represents possible values of the
    … …  
    985994    name="DeviceType"
    986995    uuid="6d9420f7-0b56-4636-99f9-7346f1b01e57"
    987   >
     996    >
    988997    <desc>
    989998      Device type.
    … …  
    10181027    name="DeviceActivity"
    10191028    uuid="6FC8AEAA-130A-4eb5-8954-3F921422D707"
    1020   >
     1029    >
    10211030    <desc>
    10221031      Device activity for <link to="IConsole::getDeviceActivity"/>.
    … …  
    10321041    name="ClipboardMode"
    10331042    uuid="33364716-4008-4701-8f14-be0fa3d62950"
    1034   >
     1043    >
    10351044    <desc>
    1036      Host-Guest clipboard interchange mode.
     1045      Host-Guest clipboard interchange mode.
    10371046    </desc>
    10381047
    … …  
    10461055    name="Scope"
    10471056    uuid="7c91096e-499e-4eca-9f9b-9001438d7855"
    1048   >
     1057    >
    10491058    <desc>
    10501059      Scope of the operation.
    … …  
    10621071    name="BIOSBootMenuMode"
    10631072    uuid="ae4fb9f7-29d2-45b4-b2c7-d579603135d5"
    1064   >
     1073    >
    10651074    <desc>
    10661075      BIOS boot menu mode.
    … …  
    10751084    name="ProcessorFeature"
    10761085    uuid="64c38e6b-8bcf-45ad-ac03-9b406287c5bf"
    1077   >
     1086    >
    10781087    <desc>
    10791088      CPU features.
    … …  
    10861095  </enum>
    10871096
    1088    <enum
     1097  <enum
    10891098    name="FirmwareType"
    10901099    uuid="b903f264-c230-483e-ac74-2b37ce60d371"
    1091    >
     1100    >
    10921101    <desc>
    10931102      Firmware type.
    … …  
    11101119  </enum>
    11111120
    1112    <enum
     1121  <enum
    11131122    name="PointingHidType"
    11141123    uuid="0d3c17a2-821a-4b2e-ae41-890c6c60aa97"
    1115    >
     1124    >
    11161125    <desc>
    11171126      Type of pointing device used in a virtual machine.
    … …  
    11351144  </enum>
    11361145
    1137    <enum
     1146  <enum
    11381147    name="KeyboardHidType"
    11391148    uuid="5a5b0996-3a3e-44bb-9019-56979812cbcc"
    1140    >
     1149    >
    11411150    <desc>
    11421151      Type of keyboard device used in a virtual machine.
    … …  
    11631172
    11641173  <interface
    1165      name="IVirtualBoxErrorInfo" extends="$errorinfo"
    1166      uuid="e053d3c0-f493-491b-a735-3a9f0b1feed4"
    1167      supportsErrorInfo="no"
    1168      wsmap="managed"
    1169      >
     1174    name="IVirtualBoxErrorInfo" extends="$errorinfo"
     1175    uuid="e053d3c0-f493-491b-a735-3a9f0b1feed4"
     1176    supportsErrorInfo="no"
     1177    wsmap="managed"
     1178    >
    11701179    <desc>
    11711180      The IVirtualBoxErrorInfo interface represents extended error information.
    … …  
    12661275    uuid="6cfe387c-74fb-4ca7-bff6-973bec8af7a3"
    12671276    wsmap="managed"
    1268   >
     1277    >
    12691278    <desc>
    12701279      The IDHCPServer interface represents the vbox dhcp server configuration.
    … …  
    13771386    uuid="d2de270c-1d4b-4c9e-843f-bbb9b47269ff"
    13781387    wsmap="managed"
    1379   >
     1388    >
    13801389    <desc>
    13811390      The IVirtualBox interface represents the main interface exposed by the
    … …  
    21922201    name="VFSType"
    21932202    uuid="813999ba-b949-48a8-9230-aadc6285e2f2"
    2194   >
     2203    >
    21952204    <desc>
    21962205      Virtual file systems supported by VFSExplorer.
    … …  
    22062215    name="VFSFileType"
    22072216    uuid="714333cd-44e2-415f-a245-d378fa9b1242"
    2208   >
     2217    >
    22092218    <desc>
    22102219      File types known by VFSExplorer.
    … …  
    22232232
    22242233  <interface
    2225      name="IVFSExplorer" extends="$unknown"
    2226      uuid="003d7f92-d38e-487f-b790-8c5e8631cb2f"
    2227      wsmap="managed"
    2228      >
     2234    name="IVFSExplorer" extends="$unknown"
     2235    uuid="003d7f92-d38e-487f-b790-8c5e8631cb2f"
     2236    wsmap="managed"
     2237    >
    22292238    <desc>
    22302239      The VFSExplorer interface unifies access to different file system
    … …  
    23272336
    23282337  <interface
    2329      name="IAppliance" extends="$unknown"
    2330      uuid="7b148032-4124-4f46-b56a-b48ac1273f5a"
    2331      wsmap="managed"
    2332      >
     2338    name="IAppliance" extends="$unknown"
     2339    uuid="7b148032-4124-4f46-b56a-b48ac1273f5a"
     2340    wsmap="managed"
     2341    >
    23332342    <desc>
    23342343        Represents a platform-independent appliance in OVF format. An instance of this is returned
    … …  
    25882597    name="VirtualSystemDescriptionType"
    25892598    uuid="c0f8f135-3a1d-417d-afa6-b38b95a91f90"
    2590   >
     2599    >
    25912600    <desc>Used with <link to="IVirtualSystemDescription" /> to describe the type of
    25922601    a configuration value.</desc>
    … …  
    26212630    name="VirtualSystemDescriptionValueType"
    26222631    uuid="56d9403f-3425-4118-9919-36f2a9b8c77c"
    2623   >
     2632    >
    26242633    <desc>Used with <link to="IVirtualSystemDescription::getValuesByType" /> to describe the value
    26252634    type to fetch.</desc>
    … …  
    26332642
    26342643  <interface
    2635      name="IVirtualSystemDescription" extends="$unknown"
    2636      uuid="d7525e6c-531a-4c51-8e04-41235083a3d8"
    2637      wsmap="managed"
    2638      >
     2644    name="IVirtualSystemDescription" extends="$unknown"
     2645    uuid="d7525e6c-531a-4c51-8e04-41235083a3d8"
     2646    wsmap="managed"
     2647    >
    26392648
    26402649    <desc>Represents one virtual system (machine) in an appliance. This interface is used in
    … …  
    27392748      </li>
    27402749      <li>
    2741          "CDROM": a virtual CD-ROM drive. The matching item in @a aExtraConfigValue[] contains the same
    2742          attachment information as with "HardDiskImage" items.
     2750        "CDROM": a virtual CD-ROM drive. The matching item in @a aExtraConfigValue[] contains the same
     2751        attachment information as with "HardDiskImage" items.
    27432752      </li>
    27442753      <li>
    … …  
    28972906
    28982907  <interface
    2899      name="IInternalMachineControl" extends="$unknown"
    2900      uuid="476126af-e223-4490-a8a0-b1f1575be013"
    2901      internal="yes"
    2902      wsmap="suppress"
    2903      >
     2908    name="IInternalMachineControl" extends="$unknown"
     2909    uuid="476126af-e223-4490-a8a0-b1f1575be013"
     2910    internal="yes"
     2911    wsmap="suppress"
     2912    >
    29042913    <method name="setRemoveSavedStateFile">
    29052914      <desc>
    … …  
    32933302
    32943303  <interface
    3295      name="IBIOSSettings" extends="$unknown"
    3296      uuid="38b54279-dc35-4f5e-a431-835b867c6b5e"
    3297      wsmap="managed"
    3298      >
     3304    name="IBIOSSettings" extends="$unknown"
     3305    uuid="38b54279-dc35-4f5e-a431-835b867c6b5e"
     3306    wsmap="managed"
     3307    >
    32993308    <desc>
    33003309        The IBIOSSettings interface represents BIOS settings of the virtual
    … …  
    33543363  </interface>
    33553364
    3356   <enum name="CleanupMode"
    3357         uuid="67897c50-7cca-47a9-83f6-ce8fd8eb5441">
     3365  <enum
     3366    name="CleanupMode"
     3367    uuid="67897c50-7cca-47a9-83f6-ce8fd8eb5441"
     3368    >
    33583369    <desc>Cleanup mode, used with <link to="IMachine::unregister" />.
    33593370    </desc>
    … …  
    33733384
    33743385  <interface
    3375      name="IEventContext" extends="$unknown"
    3376      uuid="7563F4E7-1583-40F7-B4C4-C9BA02CB0AE3"
    3377      wsmap="managed"
    3378      >
     3386    name="IEventContext" extends="$unknown"
     3387    uuid="7563F4E7-1583-40F7-B4C4-C9BA02CB0AE3"
     3388    wsmap="managed"
     3389    >
    33793390    <desc>
    33803391      Placeholder class for event contexts.
    … …  
    33843395
    33853396  <interface
    3386      name="IPciAddress" extends="$unknown"
    3387      uuid="D88B324F-DB19-4D3B-A1A9-BF5B127199A8"
    3388      wsmap="struct"
    3389      >
     3397    name="IPciAddress" extends="$unknown"
     3398    uuid="D88B324F-DB19-4D3B-A1A9-BF5B127199A8"
     3399    wsmap="struct"
     3400    >
    33903401
    33913402    <desc>
    … …  
    34263437  </interface>
    34273438
    3428     <interface
    3429      name="IPciDeviceAttachment" extends="$unknown"
    3430      uuid="91f33d6f-e621-4f70-a77e-15f0e3c714d5"
    3431      wsmap="struct"
    3432      >
     3439  <interface
     3440    name="IPciDeviceAttachment" extends="$unknown"
     3441    uuid="91f33d6f-e621-4f70-a77e-15f0e3c714d5"
     3442    wsmap="struct"
     3443    >
    34333444
    34343445    <desc>
    … …  
    34643475
    34653476  <interface
    3466      name="IMachine" extends="$unknown"
    3467      uuid="711cbb73-75af-463c-af17-8b7860c01fe8"
    3468      wsmap="managed"
    3469      >
     3477    name="IMachine" extends="$unknown"
     3478    uuid="711cbb73-75af-463c-af17-8b7860c01fe8"
     3479    wsmap="managed"
     3480    >
    34703481    <desc>
    34713482      The IMachine interface represents a virtual machine, or guest, created
    … …  
    36583669
    36593670    <attribute name="CPUExecutionCap" type="unsigned long">
    3660        <desc>
    3661          Means to limit the number of CPU cycles a guest can use. The unit
    3662          is percentage of host CPU cycles per second. The valid range
    3663          is 1 - 100. 100 (the default) implies no limit.
    3664        </desc>
     3671      <desc>
     3672        Means to limit the number of CPU cycles a guest can use. The unit
     3673        is percentage of host CPU cycles per second. The valid range
     3674        is 1 - 100. 100 (the default) implies no limit.
     3675      </desc>
    36653676    </attribute>
    36663677
    … …  
    37123723    <attribute name="firmwareType" type="FirmwareType">
    37133724      <desc>Type of firmware (such as legacy BIOS or EFI), used for initial
    3714        bootstrap in this VM.</desc>
     3725        bootstrap in this VM.</desc>
    37153726    </attribute>
    37163727
    … …  
    47594770    </method>
    47604771
    4761    <method name="removeStorageController">
     4772    <method name="removeStorageController">
    47624773      <desc>
    47634774        Removes a storage controller from the machine.
    … …  
    58455856
    58465857  <interface
    5847      name="IVRDEServerInfo" extends="$unknown"
    5848      uuid="714434a1-58c3-4aab-9049-7652c5df113b"
    5849      wsmap="struct"
    5850      >
    5851      <desc>
    5852         Contains information about the remote desktop (VRDE) server capabilities and status.
    5853         This is used in the <link to="IConsole::VRDEServerInfo" /> attribute.
    5854      </desc>
     5858    name="IVRDEServerInfo" extends="$unknown"
     5859    uuid="714434a1-58c3-4aab-9049-7652c5df113b"
     5860    wsmap="struct"
     5861    >
     5862    <desc>
     5863      Contains information about the remote desktop (VRDE) server capabilities and status.
     5864      This is used in the <link to="IConsole::VRDEServerInfo" /> attribute.
     5865    </desc>
    58555866
    58565867    <attribute name="active" type="boolean" readonly="yes">
    … …  
    59535964
    59545965  <interface
    5955      name="IConsole" extends="$unknown"
    5956      uuid="515e8e8d-f932-4d8e-9f32-79a52aead882"
    5957      wsmap="managed"
    5958      >
     5966    name="IConsole" extends="$unknown"
     5967    uuid="515e8e8d-f932-4d8e-9f32-79a52aead882"
     5968    wsmap="managed"
     5969    >
    59595970    <desc>
    59605971      The IConsole interface represents an interface to control virtual
    … …  
    66956706    name="HostNetworkInterfaceMediumType"
    66966707    uuid="1aa54aaf-2497-45a2-bfb1-8eb225e93d5b"
    6697   >
     6708    >
    66986709    <desc>
    66996710      Type of encapsulation. Ethernet encapsulation includes both wired and
    … …  
    67276738    name="HostNetworkInterfaceStatus"
    67286739    uuid="CC474A69-2710-434B-8D99-C38E5D5A6F41"
    6729   >
     6740    >
    67306741    <desc>
    67316742      Current status of the interface.
    … …  
    67536764    name="HostNetworkInterfaceType"
    67546765    uuid="67431b00-9946-48a2-bc02-b25c5919f4f3"
    6755   >
     6766    >
    67566767    <desc>
    67576768      Network interface type.
    … …  
    67626773
    67636774  <interface
    6764      name="IHostNetworkInterface" extends="$unknown"
    6765      uuid="ce6fae58-7642-4102-b5db-c9005c2320a8"
    6766      wsmap="managed"
    6767      >
     6775    name="IHostNetworkInterface" extends="$unknown"
     6776    uuid="ce6fae58-7642-4102-b5db-c9005c2320a8"
     6777    wsmap="managed"
     6778    >
    67686779    <desc>
    67696780      Represents one of host's network interfaces. IP V6 address and network
    … …  
    68636874
    68646875  <interface
    6865      name="IHost" extends="$unknown"
    6866      uuid="35b004f4-7806-4009-bfa8-d1308adba7e5"
    6867      wsmap="managed"
    6868      >
     6876    name="IHost" extends="$unknown"
     6877    uuid="35b004f4-7806-4009-bfa8-d1308adba7e5"
     6878    wsmap="managed"
     6879    >
    68696880    <desc>
    68706881      The IHost interface represents the physical machine that this VirtualBox
    … …  
    73067317
    73077318  <interface
    7308      name="ISystemProperties"
    7309      extends="$unknown"
    7310      uuid="51c81048-b261-4fa2-a44e-fd756f0db589"
    7311      wsmap="managed"
    7312      >
     7319    name="ISystemProperties"
     7320    extends="$unknown"
     7321    uuid="51c81048-b261-4fa2-a44e-fd756f0db589"
     7322    wsmap="managed"
     7323    >
    73137324    <desc>
    73147325      The ISystemProperties interface represents global properties of the given
    … …  
    75597570      <desc>
    75607571        This value specifies how many old release log files are kept.
    7561        </desc>
     7572      </desc>
    75627573    </attribute>
    75637574
    … …  
    76617672    uuid="432c1546-1354-4abf-bf08-878a32a373f5"
    76627673    wsmap="struct"
    7663   >
     7674    >
    76647675    <desc>
    76657676    </desc>
    … …  
    77377748    </attribute>
    77387749
    7739      <attribute name="recommendedHpet" type="boolean" readonly="yes">
     7750    <attribute name="recommendedHpet" type="boolean" readonly="yes">
    77407751      <desc>Returns @c true if using HPET is recommended for this OS type.</desc>
    77417752    </attribute>
    … …  
    77497760    </attribute>
    77507761
    7751      <attribute name="recommendedChipset" type="ChipsetType" readonly="yes">
     7762    <attribute name="recommendedChipset" type="ChipsetType" readonly="yes">
    77527763      <desc>Recommended chipset type.</desc>
    7753      </attribute>
    7754 
    7755      <attribute name="recommendedAudioController" type="AudioControllerType" readonly="yes">
     7764    </attribute>
     7765
     7766    <attribute name="recommendedAudioController" type="AudioControllerType" readonly="yes">
    77567767      <desc>Recommended audio type.</desc>
    7757      </attribute>
     7768    </attribute>
    77587769
    77597770  </interface>
    … …  
    77627773    name="AdditionsRunLevelType"
    77637774    uuid="a25417ee-a9dd-4f5b-b0dc-377860087754"
    7764   >
     7775    >
    77657776    <desc>
    77667777      Guest Additions run level type.
    … …  
    78017812    name="ExecuteProcessFlag"
    78027813    uuid="3258e8a5-ba0c-43d5-86b5-cf91405fddc0"
    7803   >
     7814    >
    78047815    <desc>
    78057816      Guest process execution flags.
    … …  
    78237834    name="ProcessInputFlag"
    78247835    uuid="5d38c1dd-2604-4ddf-92e5-0c0cdd3bdbd5"
    7825   >
     7836    >
    78267837    <desc>
    78277838      Guest process input flags.
    … …  
    78397850    name="CopyFileFlag"
    78407851    uuid="23f79fdf-738a-493d-b80b-42d607c9b916"
    7841   >
     7852    >
    78427853    <desc>
    78437854      Host/Guest copy flags.
    … …  
    78797890
    78807891  <interface
    7881      name="IGuest" extends="$unknown"
    7882      uuid="1039b0cc-9bc1-4c6d-8d12-864aa48aa5b9"
    7883      wsmap="managed"
    7884      >
     7892    name="IGuest" extends="$unknown"
     7893    uuid="1039b0cc-9bc1-4c6d-8d12-864aa48aa5b9"
     7894    wsmap="managed"
     7895    >
    78857896    <desc>
    78867897      The IGuest interface represents information about the operating system
    … …  
    79477958    <method name="internalGetStatistics">
    79487959      <desc>
    7949          Internal method; do not use as it might change at any time
     7960        Internal method; do not use as it might change at any time
    79507961      </desc>
    79517962      <param name="cpuUser" type="unsigned long" dir="out">
    7952          <desc>Percentage of processor time spent in user mode as seen by the guest</desc>
     7963        <desc>Percentage of processor time spent in user mode as seen by the guest</desc>
    79537964      </param>
    79547965      <param name="cpuKernel" type="unsigned long" dir="out">
    7955          <desc>Percentage of processor time spent in kernel mode as seen by the guest</desc>
     7966        <desc>Percentage of processor time spent in kernel mode as seen by the guest</desc>
    79567967      </param>
    79577968      <param name="cpuIdle" type="unsigned long" dir="out">
    7958          <desc>Percentage of processor time spent idling as seen by the guest</desc>
     7969        <desc>Percentage of processor time spent idling as seen by the guest</desc>
    79597970      </param>
    79607971      <param name="memTotal" type="unsigned long" dir="out">
    7961          <desc>Total amount of physical guest RAM</desc>
     7972        <desc>Total amount of physical guest RAM</desc>
    79627973      </param>
    79637974      <param name="memFree" type="unsigned long" dir="out">
    7964          <desc>Free amount of physical guest RAM</desc>
     7975        <desc>Free amount of physical guest RAM</desc>
    79657976      </param>
    79667977      <param name="memBalloon" type="unsigned long" dir="out">
    7967          <desc>Amount of ballooned physical guest RAM</desc>
     7978        <desc>Amount of ballooned physical guest RAM</desc>
    79687979      </param>
    79697980      <param name="memShared" type="unsigned long" dir="out">
    … …  
    79717982      </param>
    79727983      <param name="memCache" type="unsigned long" dir="out">
    7973          <desc>Total amount of guest (disk) cache memory</desc>
     7984        <desc>Total amount of guest (disk) cache memory</desc>
    79747985      </param>
    79757986      <param name="pagedTotal" type="unsigned long" dir="out">
    7976          <desc>Total amount of space in the page file</desc>
     7987        <desc>Total amount of space in the page file</desc>
    79777988      </param>
    79787989      <param name="memAllocTotal" type="unsigned long" dir="out">
    7979          <desc>Total amount of memory allocated by the hypervisor</desc>
     7990        <desc>Total amount of memory allocated by the hypervisor</desc>
    79807991      </param>
    79817992      <param name="memFreeTotal" type="unsigned long" dir="out">
    7982          <desc>Total amount of free memory available in the hypervisor</desc>
     7993        <desc>Total amount of free memory available in the hypervisor</desc>
    79837994      </param>
    79847995      <param name="memBalloonTotal" type="unsigned long" dir="out">
    7985          <desc>Total amount of memory ballooned by the hypervisor</desc>
     7996        <desc>Total amount of memory ballooned by the hypervisor</desc>
    79867997      </param>
    79877998      <param name="memSharedTotal" type="unsigned long" dir="out">
    … …  
    83178328
    83188329  <interface
    8319      name="IProgress" extends="$unknown"
    8320      uuid="A163C98F-8635-4AA8-B770-A9941737F3EF"
    8321      wsmap="managed"
    8322      >
     8330    name="IProgress" extends="$unknown"
     8331    uuid="A163C98F-8635-4AA8-B770-A9941737F3EF"
     8332    wsmap="managed"
     8333    >
    83238334    <desc>
    83248335        The IProgress interface is used to track and control
    … …  
    85368547
    85378548  <interface
    8538      name="ISnapshot" extends="$unknown"
    8539      uuid="1a2d0551-58a4-4107-857e-ef414fc42ffc"
    8540      wsmap="managed"
    8541      >
     8549    name="ISnapshot" extends="$unknown"
     8550    uuid="1a2d0551-58a4-4107-857e-ef414fc42ffc"
     8551    wsmap="managed"
     8552    >
    85428553    <desc>
    85438554      The ISnapshot interface represents a snapshot of the virtual
    … …  
    86828693    name="MediumState"
    86838694    uuid="ef41e980-e012-43cd-9dea-479d4ef14d13"
    8684   >
     8695    >
    86858696    <desc>
    86868697      Virtual medium state.
    … …  
    87368747    name="MediumType"
    87378748    uuid="19388a99-8e70-4bd4-9a95-90cbc513ef6d"
    8738    >
     8749    >
    87398750    <desc>
    87408751      Virtual medium type.
    … …  
    87778788    name="MediumVariant"
    87788789    uuid="584ea502-143b-4ab0-ad14-d1028fdf0316"
    8779    >
     8790    >
    87808791    <desc>
    87818792      Virtual medium image variant. More than one flag may be set.
    … …  
    88208831    uuid="c29452cc-ca72-404b-9261-cfc514f1e412"
    88218832    wsmap="struct"
    8822   >
     8833    >
    88238834    <desc>
    88248835      The IMediumAttachment interface links storage media to virtual machines.
    … …  
    88738884    <attribute name="bandwidthLimit" type="unsigned long">
    88748885      <desc>
    8875          Maximum throughput allowed for this medium attachment, in units of 1 mbps.
    8876          A zero value means uncapped/unlimited.
     8886        Maximum throughput allowed for this medium attachment, in units of 1 mbps.
     8887        A zero value means uncapped/unlimited.
    88778888      </desc>
    88788889    </attribute>
    … …  
    88848895    uuid="bfcf5b8c-5155-4f24-9414-9457054b16db"
    88858896    wsmap="managed"
    8886   >
     8897    >
    88878898    <desc>
    88888899      The IMedium interface represents virtual storage for a machine's
    … …  
    1028410295    name="DataType"
    1028510296    uuid="d90ea51e-a3f1-4a01-beb1-c1723c0d3ba7"
    10286   >
     10297    >
    1028710298    <const name="Int32" value="0"/>
    1028810299    <const name="Int8" value="1"/>
    … …  
    1029310304    name="DataFlags"
    1029410305    uuid="86884dcf-1d6b-4f1b-b4bf-f5aa44959d60"
    10295   >
     10306    >
    1029610307    <const name="None" value="0x00"/>
    1029710308    <const name="Mandatory" value="0x01"/>
    … …  
    1030410315    name="MediumFormatCapabilities"
    1030510316    uuid="7342ba79-7ce0-4d94-8f86-5ed5a185d9bd"
    10306   >
     10317    >
    1030710318    <desc>
    10308        Medium format capability flags.
     10319      Medium format capability flags.
    1030910320    </desc>
    1031010321
    … …  
    1038010391
    1038110392  <interface
    10382      name="IMediumFormat" extends="$unknown"
    10383      uuid="4e9a873f-0599-434a-8345-619ef3fb3111"
    10384      wsmap="managed"
    10385      >
     10393    name="IMediumFormat" extends="$unknown"
     10394    uuid="4e9a873f-0599-434a-8345-619ef3fb3111"
     10395    wsmap="managed"
     10396    >
    1038610397    <desc>
    1038710398        The IMediumFormat interface represents a medium format.
    … …  
    1050110512
    1050210513  <interface
    10503      name="IKeyboard" extends="$unknown"
    10504      uuid="f6916ec5-a881-4237-898f-7de58cf88672"
    10505      wsmap="managed"
    10506      >
     10514    name="IKeyboard" extends="$unknown"
     10515    uuid="f6916ec5-a881-4237-898f-7de58cf88672"
     10516    wsmap="managed"
     10517    >
    1050710518    <desc>
    1050810519      The IKeyboard interface represents the virtual machine's keyboard. Used
    … …  
    1056510576    name="MouseButtonState"
    1056610577    uuid="9ee094b8-b28a-4d56-a166-973cb588d7f8"
    10567   >
     10578    >
    1056810579    <desc>
    1056910580      Mouse button state.
    … …  
    1058110592
    1058210593  <interface
    10583      name="IMouse" extends="$unknown"
    10584      uuid="05044a52-7811-4f00-ae3a-0ab7ff707b10"
    10585      wsmap="managed"
    10586      >
     10594    name="IMouse" extends="$unknown"
     10595    uuid="05044a52-7811-4f00-ae3a-0ab7ff707b10"
     10596    wsmap="managed"
     10597    >
    1058710598    <desc>
    1058810599      The IMouse interface represents the virtual machine's mouse. Used in
    … …  
    1076410775    name="FramebufferPixelFormat"
    1076510776    uuid="7acfd5ed-29e3-45e3-8136-73c9224f3d2d"
    10766   >
     10777    >
    1076710778    <desc>
    1076810779      Format of the video memory buffer. Constants represented by this enum can
    … …  
    1078910800
    1079010801  <interface
    10791      name="IFramebuffer" extends="$unknown"
    10792      uuid="b7ed347a-5765-40a0-ae1c-f543eb4ddeaf"
    10793      wsmap="suppress"
    10794      >
     10802    name="IFramebuffer" extends="$unknown"
     10803    uuid="b7ed347a-5765-40a0-ae1c-f543eb4ddeaf"
     10804    wsmap="suppress"
     10805    >
    1079510806    <attribute name="address" type="octet" mod="ptr" readonly="yes">
    1079610807      <desc>Address of the start byte of the frame buffer.</desc>
    … …  
    1111811129
    1111911130  <interface
    11120      name="IFramebufferOverlay" extends="IFramebuffer"
    11121      uuid="0bcc1c7e-e415-47d2-bfdb-e4c705fb0f47"
    11122      wsmap="suppress"
    11123      >
     11131    name="IFramebufferOverlay" extends="IFramebuffer"
     11132    uuid="0bcc1c7e-e415-47d2-bfdb-e4c705fb0f47"
     11133    wsmap="suppress"
     11134    >
    1112411135    <desc>
    1112511136      The IFramebufferOverlay interface represents an alpha blended overlay
    … …  
    1116411175
    1116511176  <interface
    11166      name="IDisplay" extends="$unknown"
    11167      uuid="09EED313-CD56-4D06-BD56-FAC0F716B5DD"
    11168      wsmap="managed"
    11169      >
     11177    name="IDisplay" extends="$unknown"
     11178    uuid="09EED313-CD56-4D06-BD56-FAC0F716B5DD"
     11179    wsmap="managed"
     11180    >
    1117011181    <desc>
    1117111182      The IDisplay interface represents the virtual machine's display.
    … …  
    1143411445    name="NetworkAttachmentType"
    1143511446    uuid="44bce1ee-99f7-4e8e-89fc-80597fd9eeaf"
    11436   >
     11447    >
    1143711448    <desc>
    1143811449      Network attachment type.
    … …  
    1145211463    name="NetworkAdapterType"
    1145311464    uuid="3c2281e4-d952-4e87-8c7d-24379cb6a81c"
    11454   >
     11465    >
    1145511466    <desc>
    1145611467      Network adapter type.
    … …  
    1148111492
    1148211493  <interface
    11483      name="INetworkAdapter" extends="$unknown"
    11484      uuid="9bf58a46-c3f7-4f31-80fa-dde9a5dc0b7b"
    11485      wsmap="managed"
    11486      >
     11494    name="INetworkAdapter" extends="$unknown"
     11495    uuid="9bf58a46-c3f7-4f31-80fa-dde9a5dc0b7b"
     11496    wsmap="managed"
     11497    >
    1148711498    <desc>
    1148811499        Represents a virtual network adapter that is attached to a virtual machine.
    … …  
    1165011661    name="PortMode"
    1165111662    uuid="533b5fe3-0185-4197-86a7-17e37dd39d76"
    11652   >
     11663    >
    1165311664    <desc>
    1165411665      The PortMode enumeration represents possible communication modes for
    … …  
    1167111682
    1167211683  <interface
    11673      name="ISerialPort" extends="$unknown"
    11674      uuid="937f6970-5103-4745-b78e-d28dcf1479a8"
    11675      wsmap="managed"
    11676      >
     11684    name="ISerialPort" extends="$unknown"
     11685    uuid="937f6970-5103-4745-b78e-d28dcf1479a8"
     11686    wsmap="managed"
     11687    >
    1167711688
    1167811689    <desc>
    … …  
    1170011711    </desc>
    1170111712
    11702      <attribute name="slot" type="unsigned long" readonly="yes">
     11713    <attribute name="slot" type="unsigned long" readonly="yes">
    1170311714      <desc>
    1170411715        Slot number this serial port is plugged into. Corresponds to
    … …  
    1175911770
    1176011771  <interface
    11761      name="IParallelPort" extends="$unknown"
    11762      uuid="0c925f06-dd10-4b77-8de8-294d738c3214"
    11763      wsmap="managed"
    11764      >
     11772    name="IParallelPort" extends="$unknown"
     11773    uuid="0c925f06-dd10-4b77-8de8-294d738c3214"
     11774    wsmap="managed"
     11775    >
    1176511776
    1176611777    <desc>
    … …  
    1177911790    </desc>
    1178011791
    11781      <attribute name="slot" type="unsigned long" readonly="yes">
     11792    <attribute name="slot" type="unsigned long" readonly="yes">
    1178211793      <desc>
    1178311794        Slot number this parallel port is plugged into. Corresponds to
    … …  
    1181911830
    1182011831  <interface
    11821      name="IMachineDebugger" extends="$unknown"
    11822      uuid="b0b2a2dd-0627-4502-91c2-ddc5e77609e0"
    11823      wsmap="suppress"
    11824      >
     11832    name="IMachineDebugger" extends="$unknown"
     11833    uuid="b0b2a2dd-0627-4502-91c2-ddc5e77609e0"
     11834    wsmap="suppress"
     11835    >
    1182511836    <method name="resetStats">
    1182611837      <desc>
    … …  
    1193811949
    1193911950  <interface
    11940      name="IUSBController" extends="$unknown"
    11941      uuid="6fdcccc5-abd3-4fec-9387-2ad3914fc4a8"
    11942      wsmap="managed"
    11943      >
     11951    name="IUSBController" extends="$unknown"
     11952    uuid="6fdcccc5-abd3-4fec-9387-2ad3914fc4a8"
     11953    wsmap="managed"
     11954    >
    1194411955    <attribute name="enabled" type="boolean">
    1194511956      <desc>
    … …  
    1209612107
    1209712108  <interface
    12098      name="IUSBDevice" extends="$unknown"
    12099      uuid="f8967b0b-4483-400f-92b5-8b675d98a85b"
    12100      wsmap="managed"
    12101      >
     12109    name="IUSBDevice" extends="$unknown"
     12110    uuid="f8967b0b-4483-400f-92b5-8b675d98a85b"
     12111    wsmap="managed"
     12112    >
    1210212113    <desc>
    1210312114      The IUSBDevice interface represents a virtual USB device attached to the
    … …  
    1218512196
    1218612197  <interface
    12187      name="IUSBDeviceFilter" extends="$unknown"
    12188      uuid="d6831fb4-1a94-4c2c-96ef-8d0d6192066d"
    12189      wsmap="managed"
    12190      >
     12198    name="IUSBDeviceFilter" extends="$unknown"
     12199    uuid="d6831fb4-1a94-4c2c-96ef-8d0d6192066d"
     12200    wsmap="managed"
     12201    >
    1219112202    <desc>
    1219212203      The IUSBDeviceFilter interface represents an USB device filter used
    … …  
    1233812349    <attribute name="maskedInterfaces" type="unsigned long">
    1233912350      <desc>
    12340        This is an advanced option for hiding one or more USB interfaces
    12341        from the guest. The value is a bit mask where the bits that are set
    12342        means the corresponding USB interface should be hidden, masked off
    12343        if you like.
    12344        This feature only works on Linux hosts.
     12351        This is an advanced option for hiding one or more USB interfaces
     12352        from the guest. The value is a bit mask where the bits that are set
     12353        means the corresponding USB interface should be hidden, masked off
     12354        if you like.
     12355        This feature only works on Linux hosts.
    1234512356      </desc>
    1234612357    </attribute>
    … …  
    1235512366
    1235612367  <enum
    12357      name="USBDeviceState"
    12358      uuid="b99a2e65-67fb-4882-82fd-f3e5e8193ab4"
    12359      >
     12368    name="USBDeviceState"
     12369    uuid="b99a2e65-67fb-4882-82fd-f3e5e8193ab4"
     12370    >
    1236012371    <desc>
    1236112372      USB device state. This enumeration represents all possible states
    … …  
    1243012441
    1243112442  <interface
    12432      name="IHostUSBDevice" extends="IUSBDevice"
    12433      uuid="173b4b44-d268-4334-a00d-b6521c9a740a"
    12434      wsmap="managed"
    12435      >
     12443    name="IHostUSBDevice" extends="IUSBDevice"
     12444    uuid="173b4b44-d268-4334-a00d-b6521c9a740a"
     12445    wsmap="managed"
     12446    >
    1243612447    <desc>
    1243712448      The IHostUSBDevice interface represents a physical USB device attached
    … …  
    1246412475    name="USBDeviceFilterAction"
    1246512476    uuid="cbc30a49-2f4e-43b5-9da6-121320475933"
    12466   >
     12477    >
    1246712478    <desc>
    1246812479      Actions for host USB device filters.
    … …  
    1248212493
    1248312494  <interface
    12484      name="IHostUSBDeviceFilter" extends="IUSBDeviceFilter"
    12485      uuid="4cc70246-d74a-400f-8222-3900489c0374"
    12486      wsmap="managed"
    12487      >
     12495    name="IHostUSBDeviceFilter" extends="IUSBDeviceFilter"
     12496    uuid="4cc70246-d74a-400f-8222-3900489c0374"
     12497    wsmap="managed"
     12498    >
    1248812499    <desc>
    1248912500      The IHostUSBDeviceFilter interface represents a global filter for a
    … …  
    1252112532    name="AudioDriverType"
    1252212533    uuid="4bcc3d73-c2fe-40db-b72f-0c2ca9d68496"
    12523   >
     12534    >
    1252412535    <desc>
    1252512536      Host audio driver type.
    … …  
    1255812569    name="AudioControllerType"
    1255912570    uuid="7afd395c-42c3-444e-8788-3ce80292f36c"
    12560   >
     12571    >
    1256112572    <desc>
    1256212573      Virtual audio controller type.
    … …  
    1256912580
    1257012581  <interface
    12571      name="IAudioAdapter" extends="$unknown"
    12572      uuid="921873db-5f3f-4b69-91f9-7be9e535a2cb"
    12573      wsmap="managed"
    12574      >
     12582    name="IAudioAdapter" extends="$unknown"
     12583    uuid="921873db-5f3f-4b69-91f9-7be9e535a2cb"
     12584    wsmap="managed"
     12585    >
    1257512586    <desc>
    1257612587        The IAudioAdapter interface represents the virtual audio adapter of
    … …  
    1260112612    name="AuthType"
    1260212613    uuid="7eef6ef6-98c2-4dc2-ab35-10d2b292028d"
    12603   >
     12614    >
    1260412615    <desc>
    1260512616      VirtualBox authentication type.
    … …  
    1261912630
    1262012631  <interface
    12621      name="IVRDEServer" extends="$unknown"
    12622      uuid="468ab3d3-4808-489e-a301-05d60e959fbc"
    12623      wsmap="managed"
    12624      >
     12632    name="IVRDEServer" extends="$unknown"
     12633    uuid="468ab3d3-4808-489e-a301-05d60e959fbc"
     12634    wsmap="managed"
     12635    >
    1262512636    <attribute name="enabled" type="boolean">
    1262612637      <desc>VRDE server status.</desc>
    … …  
    1271012721
    1271112722  <interface
    12712      name="ISharedFolder" extends="$unknown"
    12713      uuid="8388da11-b559-4574-a5b7-2bd7acd5cef8"
    12714      wsmap="struct"
    12715      >
     12723    name="ISharedFolder" extends="$unknown"
     12724    uuid="8388da11-b559-4574-a5b7-2bd7acd5cef8"
     12725    wsmap="struct"
     12726    >
    1271612727    <desc>
    1271712728      The ISharedFolder interface represents a folder in the host computer's
    … …  
    1281612827
    1281712828  <interface
    12818      name="IInternalSessionControl" extends="$unknown"
    12819      uuid="06ef98a7-f7c0-45ba-bf99-9aca7a4d5530"
    12820      internal="yes"
    12821      wsmap="suppress"
    12822      >
     12829    name="IInternalSessionControl" extends="$unknown"
     12830    uuid="06ef98a7-f7c0-45ba-bf99-9aca7a4d5530"
     12831    internal="yes"
     12832    wsmap="suppress"
     12833    >
    1282312834    <method name="getPID">
    1282412835      <desc>PID of the process that has created this Session object.
    … …  
    1299913010    <method name="onCPUExecutionCapChange">
    1300013011      <desc>
    13001          Notification when the CPU execution cap changes.
     13012        Notification when the CPU execution cap changes.
    1300213013      </desc>
    1300313014      <param name="executionCap" type="unsigned long" dir="in">
    13004          <desc>The new CPU execution cap value. (1-100)</desc>
     13015        <desc>The new CPU execution cap value. (1-100)</desc>
    1300513016      </param>
    1300613017    </method>
    … …  
    1323813249
    1323913250  <interface
    13240      name="ISession" extends="$unknown"
    13241      uuid="12F4DCDB-12B2-4EC1-B7CD-DDD9F6C5BF4D"
    13242      wsmap="managed"
    13243      >
     13251    name="ISession" extends="$unknown"
     13252    uuid="12F4DCDB-12B2-4EC1-B7CD-DDD9F6C5BF4D"
     13253    wsmap="managed"
     13254    >
    1324413255    <desc>
    1324513256      The ISession interface represents a client process and allows for locking
    … …  
    1335813369    name="StorageBus"
    1335913370    uuid="eee67ab3-668d-4ef5-91e0-7025fe4a0d7a"
    13360   >
     13371    >
    1336113372    <desc>
    1336213373      The bus type of the storage controller (IDE, SATA, SCSI, SAS or Floppy);
    … …  
    1337613387    name="StorageControllerType"
    1337713388    uuid="8a412b8a-f43e-4456-bd37-b474f0879a58"
    13378   >
     13389    >
    1337913390    <desc>
    1338013391      The exact variant of storage controller hardware presented
    … …  
    1341413425    name="ChipsetType"
    1341513426    uuid="8b4096a8-a7c3-4d3b-bbb1-05a0a51ec394"
    13416   >
     13427    >
    1341713428    <desc>
    1341813429      Type of emulated chipset (mostly southbridge).
    … …  
    1343413445    uuid="a1556333-09b6-46d9-bfb7-fc239b7fbe1e"
    1343513446    wsmap="managed"
    13436   >
     13447    >
    1343713448    <desc>
    1343813449        Represents a storage controller that is attached to a virtual machine
    … …  
    1345513466
    1345613467    <attribute name="name" type="wstring" readonly="yes">
    13457      <desc>
     13468      <desc>
    1345813469        Name of the storage controller, as originally specified with
    1345913470        <link to="IMachine::addStorageController" />. This then uniquely
    … …  
    1358113592
    1358213593  <interface
    13583      name="IManagedObjectRef" extends="$unknown"
    13584      uuid="9474d09d-2313-46de-b568-a42b8718e8ed"
    13585      internal="yes"
    13586      wsmap="managed"
    13587      wscpp="hardcoded"
    13588      >
     13594    name="IManagedObjectRef" extends="$unknown"
     13595    uuid="9474d09d-2313-46de-b568-a42b8718e8ed"
     13596    internal="yes"
     13597    wsmap="managed"
     13598    wscpp="hardcoded"
     13599    >
    1358913600    <desc>
    1359013601      Managed object reference.
    … …  
    1363113642
    1363213643  <interface
    13633      name="IWebsessionManager" extends="$unknown"
    13634      uuid="dea1b4c7-2de3-418a-850d-7868617f7733"
    13635      internal="yes"
    13636      wsmap="global"
    13637      wscpp="hardcoded"
    13638      >
     13644    name="IWebsessionManager" extends="$unknown"
     13645    uuid="dea1b4c7-2de3-418a-850d-7868617f7733"
     13646    internal="yes"
     13647    wsmap="global"
     13648    wscpp="hardcoded"
     13649    >
    1363913650    <desc>
    1364013651      Websession manager. This provides essential services
    … …  
    1368513696    name="IPerformanceMetric" extends="$unknown"
    1368613697    uuid="2a1a60ae-9345-4019-ad53-d34ba41cbfe9" wsmap="managed"
    13687   >
     13698    >
    1368813699    <desc>
    1368913700      The IPerformanceMetric interface represents parameters of the given
    … …  
    1374813759    uuid="e22e1acb-ac4a-43bb-a31c-17321659b0c6"
    1374913760    wsmap="managed"
    13750   >
     13761    >
    1375113762    <desc>
    1375213763      The IPerformanceCollector interface represents a service that collects
    … …  
    1405114062      </param>
    1405214063      <param name="returnUnits" type="wstring" dir="out" safearray="yes">
    14053          <desc>
    14054            Units of measurement for each returned metric.
    14055          </desc>
    14056        </param>
    14057        <param name="returnScales" type="unsigned long" dir="out" safearray="yes">
    14058          <desc>
    14059            Divisor that should be applied to return values in order to get
    14060            floating point values. For example:
    14061            <tt>(double)returnData[returnDataIndices[0]+i] / returnScales[0]</tt>
    14062            will retrieve the floating point value of i-th sample of the first
    14063            metric.
    14064          </desc>
    14065        </param>
    14066        <param name="returnSequenceNumbers" type="unsigned long" dir="out" safearray="yes">
    14067          <desc>
    14068            Sequence numbers of the first elements of value sequences of
    14069            particular metrics returned in @c returnData. For aggregate metrics
    14070            it is the sequence number of the sample the aggregate started
    14071            calculation from.
    14072          </desc>
    14073        </param>
     14064        <desc>
     14065          Units of measurement for each returned metric.
     14066        </desc>
     14067      </param>
     14068      <param name="returnScales" type="unsigned long" dir="out" safearray="yes">
     14069        <desc>
     14070          Divisor that should be applied to return values in order to get
     14071          floating point values. For example:
     14072          <tt>(double)returnData[returnDataIndices[0]+i] / returnScales[0]</tt>
     14073          will retrieve the floating point value of i-th sample of the first
     14074          metric.
     14075        </desc>
     14076      </param>
     14077      <param name="returnSequenceNumbers" type="unsigned long" dir="out" safearray="yes">
     14078        <desc>
     14079          Sequence numbers of the first elements of value sequences of
     14080          particular metrics returned in @c returnData. For aggregate metrics
     14081          it is the sequence number of the sample the aggregate started
     14082          calculation from.
     14083        </desc>
     14084      </param>
    1407414085      <param name="returnDataIndices" type="unsigned long" dir="out" safearray="yes">
    1407514086        <desc>
    … …  
    1409214103
    1409314104  </interface>
    14094  <enum
    14095   name="NATAliasMode"
    14096   uuid="67772168-50d9-11df-9669-7fb714ee4fa1">
    14097   <desc></desc>
    14098   <const name="AliasLog" value="0x1">
     14105
     14106  <enum
     14107    name="NATAliasMode"
     14108    uuid="67772168-50d9-11df-9669-7fb714ee4fa1"
     14109    >
    1409914110    <desc></desc>
    14100   </const>
    14101   <const name="AliasProxyOnly" value="0x02">
    14102     <desc></desc>
    14103   </const>
    14104   <const name="AliasUseSamePorts" value="0x04">
    14105     <desc></desc>
    14106   </const>
    14107  </enum>
     14111    <const name="AliasLog" value="0x1">
     14112      <desc></desc>
     14113    </const>
     14114    <const name="AliasProxyOnly" value="0x02">
     14115      <desc></desc>
     14116    </const>
     14117    <const name="AliasUseSamePorts" value="0x04">
     14118      <desc></desc>
     14119    </const>
     14120  </enum>
     14121
    1410814122  <enum
    1410914123    name="NATProtocol"
    1411014124    uuid="e90164be-eb03-11de-94af-fff9b1c1b19f"
    14111   >
     14125    >
    1411214126    <desc>Protocol definitions used with NAT port-forwarding rules.</desc>
    1411314127    <const name="UDP" value="0">
    … …  
    1412014134
    1412114135  <interface
    14122      name="INATEngine" extends="$unknown"
    14123      uuid="4b286616-eb03-11de-b0fb-1701eca42246"
    14124      wsmap="managed"
    14125      >
    14126      <desc>Interface for managing a NAT engine which is used with a virtual machine. This
    14127        allows for changing NAT behavior such as port-forwarding rules. This interface is
    14128        used in the <link to="INetworkAdapter::natDriver" /> attribute.</desc>
     14136    name="INATEngine" extends="$unknown"
     14137    uuid="4b286616-eb03-11de-b0fb-1701eca42246"
     14138    wsmap="managed"
     14139    >
     14140    <desc>Interface for managing a NAT engine which is used with a virtual machine. This
     14141      allows for changing NAT behavior such as port-forwarding rules. This interface is
     14142      used in the <link to="INetworkAdapter::natDriver" /> attribute.</desc>
    1412914143    <attribute name="network" type="wstring">
    1413014144      <desc>The network attribute of the NAT engine (the same value is used with built-in
    … …  
    1439814412
    1439914413  <!--
     14414  // IVirtualBoxClient
     14415  /////////////////////////////////////////////////////////////////////////
     14416  -->
     14417
     14418  <interface
     14419    name="IVirtualBoxClient" extends="$unknown"
     14420    uuid="5fe0bd48-1181-40d1-991f-3b02f269a823"
     14421    wsmap="suppress"
     14422    >
     14423    <desc>
     14424      Convenience interface for client applications. Treat this as a
     14425      singleton, i.e. never create more than one instance of this interface.
     14426
     14427      At the moment only available for clients of the local API (not usable
     14428      via the webservice). Once the session logic is redesigned this might
     14429      change.
     14430    </desc>
     14431
     14432    <attribute name="virtualBox" type="IVirtualBox" readonly="yes">
     14433      <desc>
     14434        Reference to the server-side API root object.
     14435      </desc>
     14436    </attribute>
     14437
     14438    <attribute name="session" type="ISession" readonly="yes">
     14439      <desc>
     14440        Create a new session object and return the reference to it.
     14441      </desc>
     14442    </attribute>
     14443
     14444    <attribute name="eventSource" type="IEventSource" readonly="yes">
     14445      <desc>
     14446        Event source for VirtualBoxClient events.
     14447      </desc>
     14448    </attribute>
     14449
     14450  </interface>
     14451
     14452  <!--
    1440014453  // Events
    1440114454  /////////////////////////////////////////////////////////////////////////
    1440214455  -->
    1440314456  <enum
    14404      name="VBoxEventType"
    14405      uuid="BA0F90B2-3F41-4222-840D-EDD5055476A8">
     14457    name="VBoxEventType"
     14458    uuid="BA0F90B2-3F41-4222-840D-EDD5055476A8"
     14459    >
    1440614460
    1440714461    <desc>
    … …  
    1447414528      </desc>
    1447514529    </const>
    14476      <const name="OnExtraDataCanChange" value="35">
     14530    <const name="OnExtraDataCanChange" value="35">
    1447714531      <desc>
    1447814532        See <link to="IExtraDataCanChangeEvent">IExtraDataCanChangeEvent</link>.
    … …  
    1464014694      </desc>
    1464114695    </const>
     14696    <const name="OnVBoxSVCUnavailable" value="68">
     14697      <desc>
     14698        See <link to="IVBoxSVCUnavailableEvent">IVBoxSVCUnavailableEvent</link>.
     14699      </desc>
     14700    </const>
    1464214701
    1464314702    <!-- Last event marker -->
    14644     <const name="Last" value="68">
     14703    <const name="Last" value="69">
    1464514704      <desc>
    1464614705        Must be last event, used for iterations and structures relying on numerical event values.
    … …  
    1465114710
    1465214711  <interface
    14653      name="IEventSource" extends="$unknown"
    14654      uuid="9b6e1aee-35f3-4f4d-b5bb-ed0ecefd8538"
    14655      wsmap="managed"
    14656      >
     14712    name="IEventSource" extends="$unknown"
     14713    uuid="9b6e1aee-35f3-4f4d-b5bb-ed0ecefd8538"
     14714    wsmap="managed"
     14715    >
    1465714716    <desc>
    1465814717      Event source. Generally, any object which could generate events can be an event source,
    … …  
    1479014849
    1479114850  <interface
    14792      name="IEventListener" extends="$unknown"
    14793      uuid="67099191-32e7-4f6c-85ee-422304c71b90"
    14794      wsmap="managed"
    14795      >
     14851    name="IEventListener" extends="$unknown"
     14852    uuid="67099191-32e7-4f6c-85ee-422304c71b90"
     14853    wsmap="managed"
     14854    >
    1479614855    <desc>
    1479714856      Event listener. An event listener can work in either active or passive mode, depending on the way
    … …  
    1481314872
    1481414873  <interface
    14815      name="IEvent" extends="$unknown"
    14816      uuid="0ca2adba-8f30-401b-a8cd-fe31dbe839c0"
    14817      wsmap="managed"
    14818      >
     14874    name="IEvent" extends="$unknown"
     14875    uuid="0ca2adba-8f30-401b-a8cd-fe31dbe839c0"
     14876    wsmap="managed"
     14877    >
    1481914878    <desc>
    1482014879      Abstract parent interface for VirtualBox events. Actual events will typically implement
    … …  
    1493914998
    1494014999
    14941    <interface
    14942       name="IReusableEvent" extends="IEvent"
    14943       uuid="69bfb134-80f6-4266-8e20-16371f68fa25"
    14944       wsmap="managed"
    14945       >
     15000  <interface
     15001    name="IReusableEvent" extends="IEvent"
     15002    uuid="69bfb134-80f6-4266-8e20-16371f68fa25"
     15003    wsmap="managed"
     15004    >
    1494615005    <desc>Base abstract interface for all reusable events.</desc>
    1494715006
    … …  
    1495915018
    1496015019  <interface
    14961       name="IMachineEvent" extends="IEvent"
    14962       uuid="92ed7b1a-0d96-40ed-ae46-a564d484325e"
    14963       wsmap="managed" id="MachineEvent"
    14964       >
     15020    name="IMachineEvent" extends="IEvent"
     15021    uuid="92ed7b1a-0d96-40ed-ae46-a564d484325e"
     15022    wsmap="managed" id="MachineEvent"
     15023    >
    1496515024    <desc>Base abstract interface for all machine events.</desc>
    1496615025
    … …  
    1497215031
    1497315032  <interface
    14974       name="IMachineStateChangedEvent" extends="IMachineEvent"
    14975       uuid="5748F794-48DF-438D-85EB-98FFD70D18C9"
    14976       wsmap="managed" autogen="VBoxEvent" id="OnMachineStateChanged"
    14977       >
     15033    name="IMachineStateChangedEvent" extends="IMachineEvent"
     15034    uuid="5748F794-48DF-438D-85EB-98FFD70D18C9"
     15035    wsmap="managed" autogen="VBoxEvent" id="OnMachineStateChanged"
     15036    >
    1497815037    <desc>Machine state change event.</desc>
    1497915038
    … …  
    1498415043
    1498515044  <interface
    14986       name="IMachineDataChangedEvent" extends="IMachineEvent"
    14987       uuid="6AA70A6C-0DCA-4810-8C5C-457B278E3D49"
    14988       wsmap="managed" autogen="VBoxEvent" id="OnMachineDataChanged"
    14989       >
     15045    name="IMachineDataChangedEvent" extends="IMachineEvent"
     15046    uuid="6AA70A6C-0DCA-4810-8C5C-457B278E3D49"
     15047    wsmap="managed" autogen="VBoxEvent" id="OnMachineDataChanged"
     15048    >
    1499015049    <desc>
    1499115050      Any of the settings of the given machine has changed.
    … …  
    1499415053
    1499515054  <interface
    14996       name="IMediumRegisteredEvent" extends="IEvent"
    14997       uuid="53fac49a-b7f1-4a5a-a4ef-a11dd9c2a458"
    14998       wsmap="managed" autogen="VBoxEvent" id="OnMediumRegistered"
    14999       >
     15055    name="IMediumRegisteredEvent" extends="IEvent"
     15056    uuid="53fac49a-b7f1-4a5a-a4ef-a11dd9c2a458"
     15057    wsmap="managed" autogen="VBoxEvent" id="OnMediumRegistered"
     15058    >
    1500015059    <desc>
    1500115060      The given medium was registered or unregistered
    … …  
    1502015079
    1502115080  <interface
    15022       name="IMachineRegisteredEvent" extends="IMachineEvent"
    15023       uuid="c354a762-3ff2-4f2e-8f09-07382ee25088"
    15024       wsmap="managed" autogen="VBoxEvent" id="OnMachineRegistered"
    15025       >
     15081    name="IMachineRegisteredEvent" extends="IMachineEvent"
     15082    uuid="c354a762-3ff2-4f2e-8f09-07382ee25088"
     15083    wsmap="managed" autogen="VBoxEvent" id="OnMachineRegistered"
     15084    >
    1502615085    <desc>
    1502715086      The given machine was registered or unregistered
    … …  
    1503815097
    1503915098  <interface
    15040       name="ISessionStateChangedEvent" extends="IMachineEvent"
    15041       uuid="714a3eef-799a-4489-86cd-fe8e45b2ff8e"
    15042       wsmap="managed" autogen="VBoxEvent" id="OnSessionStateChanged"
    15043       >
     15099    name="ISessionStateChangedEvent" extends="IMachineEvent"
     15100    uuid="714a3eef-799a-4489-86cd-fe8e45b2ff8e"
     15101    wsmap="managed" autogen="VBoxEvent" id="OnSessionStateChanged"
     15102    >
    1504415103    <desc>
    1504515104      The state of the session for the given machine was changed.
    … …  
    1505515114
    1505615115  <interface
    15057       name="IGuestPropertyChangedEvent" extends="IMachineEvent"
    15058       uuid="3f63597a-26f1-4edb-8dd2-6bddd0912368"
    15059       wsmap="managed" autogen="VBoxEvent" id="OnGuestPropertyChanged"
    15060       >
     15116    name="IGuestPropertyChangedEvent" extends="IMachineEvent"
     15117    uuid="3f63597a-26f1-4edb-8dd2-6bddd0912368"
     15118    wsmap="managed" autogen="VBoxEvent" id="OnGuestPropertyChanged"
     15119    >
    1506115120    <desc>
    1506215121      Notification when a guest property has changed.
    … …  
    1507515134    </attribute>
    1507615135
    15077      <attribute name="flags" readonly="yes" type="wstring">
     15136    <attribute name="flags" readonly="yes" type="wstring">
    1507815137      <desc>
    1507915138        The new property flags.
    … …  
    1508415143
    1508515144  <interface
    15086       name="ISnapshotEvent" extends="IMachineEvent"
    15087       uuid="21637b0e-34b8-42d3-acfb-7e96daf77c22"
    15088       wsmap="managed" id="SnapshotEvent"
    15089       >
     15145    name="ISnapshotEvent" extends="IMachineEvent"
     15146    uuid="21637b0e-34b8-42d3-acfb-7e96daf77c22"
     15147    wsmap="managed" id="SnapshotEvent"
     15148    >
    1509015149    <desc>Base interface for all snapshot events.</desc>
    1509115150
    … …  
    1509715156
    1509815157  <interface
    15099      name="ISnapshotTakenEvent" extends="ISnapshotEvent"
    15100      uuid="d27c0b3d-6038-422c-b45e-6d4a0503d9f1"
    15101      wsmap="managed" autogen="VBoxEvent" id="OnSnapshotTaken"
    15102      >
     15158    name="ISnapshotTakenEvent" extends="ISnapshotEvent"
     15159    uuid="d27c0b3d-6038-422c-b45e-6d4a0503d9f1"
     15160    wsmap="managed" autogen="VBoxEvent" id="OnSnapshotTaken"
     15161    >
    1510315162    <desc>
    1510415163      A new snapshot of the machine has been taken.
    … …  
    1510815167
    1510915168  <interface
    15110      name="ISnapshotDeletedEvent" extends="ISnapshotEvent"
    15111      uuid="c48f3401-4a9e-43f4-b7a7-54bd285e22f4"
    15112      wsmap="managed" autogen="VBoxEvent" id="OnSnapshotDeleted"
    15113      >
     15169    name="ISnapshotDeletedEvent" extends="ISnapshotEvent"
     15170    uuid="c48f3401-4a9e-43f4-b7a7-54bd285e22f4"
     15171    wsmap="managed" autogen="VBoxEvent" id="OnSnapshotDeleted"
     15172    >
    1511415173    <desc>
    1511515174      Snapshot of the given machine has been deleted.
    … …  
    1512615185
    1512715186  <interface
    15128      name="ISnapshotChangedEvent" extends="ISnapshotEvent"
    15129      uuid="07541941-8079-447a-a33e-47a69c7980db"
    15130      wsmap="managed" autogen="VBoxEvent" id="OnSnapshotChanged"
    15131      >
     15187    name="ISnapshotChangedEvent" extends="ISnapshotEvent"
     15188    uuid="07541941-8079-447a-a33e-47a69c7980db"
     15189    wsmap="managed" autogen="VBoxEvent" id="OnSnapshotChanged"
     15190    >
    1513215191    <desc>
    1513315192      Snapshot properties (name and/or description) have been changed.
    … …  
    1513715196
    1513815197  <interface
    15139      name="IMousePointerShapeChangedEvent" extends="IEvent"
    15140      uuid="a6dcf6e8-416b-4181-8c4a-45ec95177aef"
    15141      wsmap="managed" autogen="VBoxEvent" id="OnMousePointerShapeChanged"
    15142      >
     15198    name="IMousePointerShapeChangedEvent" extends="IEvent"
     15199    uuid="a6dcf6e8-416b-4181-8c4a-45ec95177aef"
     15200    wsmap="managed" autogen="VBoxEvent" id="OnMousePointerShapeChanged"
     15201    >
    1514315202    <desc>
    1514415203      Notification when the guest mouse pointer shape has
    … …  
    1516815227    <attribute name="width" type="unsigned long" readonly="yes">
    1516915228      <desc>
    15170        Width of the pointer shape in pixels.
     15229        Width of the pointer shape in pixels.
    1517115230      </desc>
    1517215231    </attribute>
    1517315232    <attribute name="height" type="unsigned long" readonly="yes">
    1517415233      <desc>
    15175        Height of the pointer shape in pixels.
     15234        Height of the pointer shape in pixels.
    1517615235      </desc>
    1517715236    </attribute>
    … …  
    1521015269
    1521115270  <interface
    15212      name="IMouseCapabilityChangedEvent" extends="IEvent"
    15213      uuid="d633ad48-820c-4207-b46c-6bd3596640d5"
    15214      wsmap="managed" autogen="VBoxEvent" id="OnMouseCapabilityChanged"
    15215      >
     15271    name="IMouseCapabilityChangedEvent" extends="IEvent"
     15272    uuid="d633ad48-820c-4207-b46c-6bd3596640d5"
     15273    wsmap="managed" autogen="VBoxEvent" id="OnMouseCapabilityChanged"
     15274    >
    1521615275    <desc>
    1521715276      Notification when the mouse capabilities reported by the
    … …  
    1523615295
    1523715296  <interface
    15238      name="IKeyboardLedsChangedEvent" extends="IEvent"
    15239      uuid="6DDEF35E-4737-457B-99FC-BC52C851A44F"
    15240      wsmap="managed" autogen="VBoxEvent" id="OnKeyboardLedsChanged"
    15241      >
     15297    name="IKeyboardLedsChangedEvent" extends="IEvent"
     15298    uuid="6DDEF35E-4737-457B-99FC-BC52C851A44F"
     15299    wsmap="managed" autogen="VBoxEvent" id="OnKeyboardLedsChanged"
     15300    >
    1524215301    <desc>
    1524315302      Notification when the guest OS executes the KBD_CMD_SET_LEDS command
    … …  
    1526215321
    1526315322  <interface
    15264      name="IStateChangedEvent" extends="IEvent"
    15265      uuid="4376693C-CF37-453B-9289-3B0F521CAF27"
    15266      wsmap="managed" autogen="VBoxEvent" id="OnStateChanged"
    15267      >
     15323    name="IStateChangedEvent" extends="IEvent"
     15324    uuid="4376693C-CF37-453B-9289-3B0F521CAF27"
     15325    wsmap="managed" autogen="VBoxEvent" id="OnStateChanged"
     15326    >
    1526815327    <desc>
    1526915328      Notification when the execution state of the machine has changed.
    … …  
    1527815337
    1527915338  <interface
    15280      name="IAdditionsStateChangedEvent" extends="IEvent"
    15281      uuid="D70F7915-DA7C-44C8-A7AC-9F173490446A"
    15282      wsmap="managed" autogen="VBoxEvent" id="OnAdditionsStateChanged"
    15283      >
     15339    name="IAdditionsStateChangedEvent" extends="IEvent"
     15340    uuid="D70F7915-DA7C-44C8-A7AC-9F173490446A"
     15341    wsmap="managed" autogen="VBoxEvent" id="OnAdditionsStateChanged"
     15342    >
    1528415343    <desc>
    1528515344      Notification when a Guest Additions property changes.
    … …  
    1529015349
    1529115350  <interface
    15292      name="INetworkAdapterChangedEvent" extends="IEvent"
    15293      uuid="08889892-1EC6-4883-801D-77F56CFD0103"
    15294      wsmap="managed" autogen="VBoxEvent" id="OnNetworkAdapterChanged"
    15295      >
     15351    name="INetworkAdapterChangedEvent" extends="IEvent"
     15352    uuid="08889892-1EC6-4883-801D-77F56CFD0103"
     15353    wsmap="managed" autogen="VBoxEvent" id="OnNetworkAdapterChanged"
     15354    >
    1529615355    <desc>
    1529715356      Notification when a property of one of the
    … …  
    1530815367
    1530915368  <interface
    15310      name="ISerialPortChangedEvent" extends="IEvent"
    15311      uuid="3BA329DC-659C-488B-835C-4ECA7AE71C6C"
    15312      wsmap="managed" autogen="VBoxEvent" id="OnSerialPortChanged"
    15313      >
     15369    name="ISerialPortChangedEvent" extends="IEvent"
     15370    uuid="3BA329DC-659C-488B-835C-4ECA7AE71C6C"
     15371    wsmap="managed" autogen="VBoxEvent" id="OnSerialPortChanged"
     15372    >
    1531415373    <desc>
    1531515374      Notification when a property of one of the
    … …  
    1532615385
    1532715386  <interface
    15328      name="IParallelPortChangedEvent" extends="IEvent"
    15329      uuid="813C99FC-9849-4F47-813E-24A75DC85615"
    15330      wsmap="managed" autogen="VBoxEvent" id="OnParallelPortChanged"
    15331      >
     15387    name="IParallelPortChangedEvent" extends="IEvent"
     15388    uuid="813C99FC-9849-4F47-813E-24A75DC85615"
     15389    wsmap="managed" autogen="VBoxEvent" id="OnParallelPortChanged"
     15390    >
    1533215391    <desc>
    1533315392      Notification when a property of one of the
    … …  
    1534415403
    1534515404  <interface
    15346      name="IStorageControllerChangedEvent" extends="IEvent"
    15347      uuid="715212BF-DA59-426E-8230-3831FAA52C56"
    15348      wsmap="managed" autogen="VBoxEvent" id="OnStorageControllerChanged"
    15349      >
     15405    name="IStorageControllerChangedEvent" extends="IEvent"
     15406    uuid="715212BF-DA59-426E-8230-3831FAA52C56"
     15407    wsmap="managed" autogen="VBoxEvent" id="OnStorageControllerChanged"
     15408    >
    1535015409    <desc>
    1535115410      Notification when a
    … …  
    1535615415
    1535715416  <interface
    15358      name="IMediumChangedEvent" extends="IEvent"
    15359      uuid="0FE2DA40-5637-472A-9736-72019EABD7DE"
    15360      wsmap="managed" autogen="VBoxEvent" id="OnMediumChanged"
    15361      >
     15417    name="IMediumChangedEvent" extends="IEvent"
     15418    uuid="0FE2DA40-5637-472A-9736-72019EABD7DE"
     15419    wsmap="managed" autogen="VBoxEvent" id="OnMediumChanged"
     15420    >
    1536215421    <desc>
    1536315422      Notification when a
    … …  
    1537315432
    1537415433  <interface
    15375      name="ICPUChangedEvent" extends="IEvent"
    15376      uuid="D0F0BECC-EE17-4D17-A8CC-383B0EB55E9D"
    15377      wsmap="managed" autogen="VBoxEvent" id="OnCPUChanged"
    15378      >
     15434    name="ICPUChangedEvent" extends="IEvent"
     15435    uuid="D0F0BECC-EE17-4D17-A8CC-383B0EB55E9D"
     15436    wsmap="managed" autogen="VBoxEvent" id="OnCPUChanged"
     15437    >
    1537915438    <desc>
    1538015439      Notification when a CPU changes.
    … …  
    1539715456    wsmap="managed" autogen="VBoxEvent" id="OnCPUExecutionCapChanged"
    1539815457    >
    15399    <desc>
     15458    <desc>
    1540015459      Notification when the CPU execution cap changes.
    15401    </desc>
    15402      <attribute name="executionCap" type="unsigned long" readonly="yes">
    15403        <desc>
    15404          The new CPU execution cap value. (1-100)
    15405        </desc>
    15406      </attribute>
     15460    </desc>
     15461    <attribute name="executionCap" type="unsigned long" readonly="yes">
     15462      <desc>
     15463        The new CPU execution cap value. (1-100)
     15464      </desc>
     15465    </attribute>
    1540715466  </interface>
    1540815467
    … …  
    1541215471    wsmap="managed" autogen="VBoxEvent" id="OnGuestKeyboard"
    1541315472    >
    15414    <desc>
     15473    <desc>
    1541515474      Notification when guest keyboard event happens.
    15416    </desc>
    15417      <attribute name="scancodes"  type="long" safearray="yes" readonly="yes">
    15418        <desc>
    15419          Array of scancodes.
    15420        </desc>
    15421      </attribute>
     15475    </desc>
     15476    <attribute name="scancodes"  type="long" safearray="yes" readonly="yes">
     15477      <desc>
     15478        Array of scancodes.
     15479      </desc>
     15480    </attribute>
    1542215481  </interface>
    1542315482
    … …  
    1542715486    wsmap="managed" autogen="VBoxEvent" id="OnGuestMouse"
    1542815487    >
    15429    <desc>
     15488    <desc>
    1543015489      Notification when guest mouse event happens.
    15431    </desc>
    15432 
    15433    <attribute name="absolute" type="boolean" readonly="yes">
    15434      <desc>
    15435        If this event is relative or absolute.
    15436      </desc>
    15437    </attribute>
    15438 
    15439    <attribute name="x" type="long" readonly="yes">
    15440      <desc>
    15441        New X position, or X delta.
    15442      </desc>
    15443    </attribute>
    15444 
    15445    <attribute name="y" type="long" readonly="yes">
    15446      <desc>
    15447        New Y position, or Y delta.
    15448      </desc>
    15449    </attribute>
    15450 
    15451    <attribute name="z" type="long" readonly="yes">
    15452      <desc>
    15453        Z delta.
    15454      </desc>
    15455    </attribute>
    15456 
    15457    <attribute name="w" type="long" readonly="yes">
    15458      <desc>
    15459        W delta.
    15460      </desc>
    15461    </attribute>
    15462 
    15463    <attribute name="buttons" type="long" readonly="yes">
    15464      <desc>
    15465        Button state bitmask.
    15466      </desc>
    15467    </attribute>
    15468 
    15469    </interface>
    15470 
    15471 
    15472    <interface
    15473      name="IVRDEServerChangedEvent" extends="IEvent"
    15474      uuid="a06fd66a-3188-4c8c-8756-1395e8cb691c"
    15475      wsmap="managed" autogen="VBoxEvent" id="OnVRDEServerChanged"
    15476      >
     15490    </desc>
     15491
     15492    <attribute name="absolute" type="boolean" readonly="yes">
     15493      <desc>
     15494        If this event is relative or absolute.
     15495      </desc>
     15496    </attribute>
     15497
     15498    <attribute name="x" type="long" readonly="yes">
     15499      <desc>
     15500        New X position, or X delta.
     15501      </desc>
     15502    </attribute>
     15503
     15504    <attribute name="y" type="long" readonly="yes">
     15505      <desc>
     15506        New Y position, or Y delta.
     15507      </desc>
     15508    </attribute>
     15509
     15510    <attribute name="z" type="long" readonly="yes">
     15511      <desc>
     15512        Z delta.
     15513      </desc>
     15514    </attribute>
     15515
     15516    <attribute name="w" type="long" readonly="yes">
     15517      <desc>
     15518        W delta.
     15519      </desc>
     15520    </attribute>
     15521
     15522    <attribute name="buttons" type="long" readonly="yes">
     15523      <desc>
     15524        Button state bitmask.
     15525      </desc>
     15526    </attribute>
     15527
     15528  </interface>
     15529
     15530
     15531  <interface
     15532    name="IVRDEServerChangedEvent" extends="IEvent"
     15533    uuid="a06fd66a-3188-4c8c-8756-1395e8cb691c"
     15534    wsmap="managed" autogen="VBoxEvent" id="OnVRDEServerChanged"
     15535    >
    1547715536    <desc>
    1547815537      Notification when a property of the
    … …  
    1548315542  </interface>
    1548415543
    15485    <interface
    15486      name="IVRDEServerInfoChangedEvent" extends="IEvent"
    15487      uuid="dd6a1080-e1b7-4339-a549-f0878115596e"
    15488      wsmap="managed" autogen="VBoxEvent" id="OnVRDEServerInfoChanged"
    15489      >
     15544  <interface
     15545    name="IVRDEServerInfoChangedEvent" extends="IEvent"
     15546    uuid="dd6a1080-e1b7-4339-a549-f0878115596e"
     15547    wsmap="managed" autogen="VBoxEvent" id="OnVRDEServerInfoChanged"
     15548    >
    1549015549    <desc>
    1549115550      Notification when the status of the VRDE server changes. Interested callees
    … …  
    1549615555
    1549715556  <interface
    15498      name="IUSBControllerChangedEvent" extends="IEvent"
    15499      uuid="93BADC0C-61D9-4940-A084-E6BB29AF3D83"
    15500      wsmap="managed" autogen="VBoxEvent" id="OnUSBControllerChanged"
    15501      >
     15557    name="IUSBControllerChangedEvent" extends="IEvent"
     15558    uuid="93BADC0C-61D9-4940-A084-E6BB29AF3D83"
     15559    wsmap="managed" autogen="VBoxEvent" id="OnUSBControllerChanged"
     15560    >
    1550215561    <desc>
    1550315562      Notification when a property of the virtual
    … …  
    1550915568
    1551015569  <interface
    15511      name="IUSBDeviceStateChangedEvent" extends="IEvent"
    15512      uuid="806da61b-6679-422a-b629-51b06b0c6d93"
    15513      wsmap="managed" autogen="VBoxEvent" id="OnUSBDeviceStateChanged"
    15514      >
     15570    name="IUSBDeviceStateChangedEvent" extends="IEvent"
     15571    uuid="806da61b-6679-422a-b629-51b06b0c6d93"
     15572    wsmap="managed" autogen="VBoxEvent" id="OnUSBDeviceStateChanged"
     15573    >
    1551515574    <desc>
    1551615575      Notification when a USB device is attached to or detached from
    … …  
    1554915608  </interface>
    1555015609
    15551    <interface
    15552      name="ISharedFolderChangedEvent" extends="IEvent"
    15553      uuid="B66349B5-3534-4239-B2DE-8E1535D94C0B"
    15554      wsmap="managed" autogen="VBoxEvent" id="OnSharedFolderChanged"
    15555      >
     15610  <interface
     15611    name="ISharedFolderChangedEvent" extends="IEvent"
     15612    uuid="B66349B5-3534-4239-B2DE-8E1535D94C0B"
     15613    wsmap="managed" autogen="VBoxEvent" id="OnSharedFolderChanged"
     15614    >
    1555615615    <desc>
    1555715616      Notification when a shared folder is added or removed.
    … …  
    1557315632  </interface>
    1557415633
    15575    <interface
    15576      name="IRuntimeErrorEvent" extends="IEvent"
    15577      uuid="883DD18B-0721-4CDE-867C-1A82ABAF914C"
    15578      wsmap="managed" autogen="VBoxEvent" id="OnRuntimeError"
    15579      >
     15634  <interface
     15635    name="IRuntimeErrorEvent" extends="IEvent"
     15636    uuid="883DD18B-0721-4CDE-867C-1A82ABAF914C"
     15637    wsmap="managed" autogen="VBoxEvent" id="OnRuntimeError"
     15638    >
    1558015639    <desc>
    1558115640      Notification when an error happens during the virtual
    … …  
    1563815697      </desc>
    1563915698    </attribute>
    15640      <attribute name="message" type="wstring" readonly="yes">
     15699    <attribute name="message" type="wstring" readonly="yes">
    1564115700      <desc>
    1564215701        Optional error message.
    … …  
    1564615705
    1564715706
    15648    <interface
    15649      name="IEventSourceChangedEvent" extends="IEvent"
    15650      uuid="e7932cb8-f6d4-4ab6-9cbf-558eb8959a6a"
    15651      waitable="yes"
    15652      wsmap="managed" autogen="VBoxEvent" id="OnEventSourceChanged"
    15653      >
     15707  <interface
     15708    name="IEventSourceChangedEvent" extends="IEvent"
     15709    uuid="e7932cb8-f6d4-4ab6-9cbf-558eb8959a6a"
     15710    waitable="yes"
     15711    wsmap="managed" autogen="VBoxEvent" id="OnEventSourceChanged"
     15712    >
    1565415713    <desc>
    1565515714      Notification when an event source state changes (listener added or removed).
    … …  
    1567015729
    1567115730  <interface
    15672       name="IExtraDataChangedEvent" extends="IEvent"
    15673       uuid="024F00CE-6E0B-492A-A8D0-968472A94DC7"
    15674       wsmap="managed" autogen="VBoxEvent" id="OnExtraDataChanged"
    15675       >
     15731    name="IExtraDataChangedEvent" extends="IEvent"
     15732    uuid="024F00CE-6E0B-492A-A8D0-968472A94DC7"
     15733    wsmap="managed" autogen="VBoxEvent" id="OnExtraDataChanged"
     15734    >
    1567615735    <desc>
    1567715736      Notification when machine specific or global extra data
    … …  
    1569715756
    1569815757  <interface
    15699       name="IVetoEvent" extends="IEvent"
    15700       uuid="9a1a4130-69fe-472f-ac10-c6fa25d75007"
    15701       wsmap="managed"
    15702       >
     15758    name="IVetoEvent" extends="IEvent"
     15759    uuid="9a1a4130-69fe-472f-ac10-c6fa25d75007"
     15760    wsmap="managed"
     15761    >
    1570315762    <desc>Base abstract interface for veto events.</desc>
    1570415763
    … …  
    1573915798
    1574015799  <interface
    15741       name="IExtraDataCanChangeEvent" extends="IVetoEvent"
    15742       uuid="245d88bd-800a-40f8-87a6-170d02249a55"
    15743       wsmap="managed" autogen="VBoxEvent" id="OnExtraDataCanChange"
    15744       waitable="true"
    15745       >
     15800    name="IExtraDataCanChangeEvent" extends="IVetoEvent"
     15801    uuid="245d88bd-800a-40f8-87a6-170d02249a55"
     15802    wsmap="managed" autogen="VBoxEvent" id="OnExtraDataCanChange"
     15803    waitable="true"
     15804    >
    1574615805    <desc>
    1574715806      Notification when someone tries to change extra data for
    … …  
    1576815827
    1576915828  <interface
    15770       name="ICanShowWindowEvent" extends="IVetoEvent"
    15771       uuid="adf292b0-92c9-4a77-9d35-e058b39fe0b9"
    15772       wsmap="managed" autogen="VBoxEvent" id="OnCanShowWindow"
    15773       waitable="true"
    15774       >
     15829    name="ICanShowWindowEvent" extends="IVetoEvent"
     15830    uuid="adf292b0-92c9-4a77-9d35-e058b39fe0b9"
     15831    wsmap="managed" autogen="VBoxEvent" id="OnCanShowWindow"
     15832    waitable="true"
     15833    >
    1577515834    <desc>
    1577615835      Notification when a call to
    … …  
    1578715846
    1578815847  <interface
    15789       name="IShowWindowEvent" extends="IEvent"
    15790       uuid="B0A0904D-2F05-4D28-855F-488F96BAD2B2"
    15791       wsmap="managed" autogen="VBoxEvent" id="OnShowWindow"
    15792       waitable="true"
    15793       >
     15848    name="IShowWindowEvent" extends="IEvent"
     15849    uuid="B0A0904D-2F05-4D28-855F-488F96BAD2B2"
     15850    wsmap="managed" autogen="VBoxEvent" id="OnShowWindow"
     15851    waitable="true"
     15852    >
    1579415853    <desc>
    15795        Notification when a call to
    15796         <link to="IMachine::showConsoleWindow"/>
    15797         requests the console window to be activated and brought to
    15798         foreground on the desktop of the host PC.
    15799 
    15800         This notification should cause the VM console process to
    15801         perform the requested action as described above. If it is
    15802         impossible to do it at a time of this notification, this
    15803         method should return a failure.
    15804 
    15805         Note that many modern window managers on many platforms
    15806         implement some sort of focus stealing prevention logic, so
    15807         that it may be impossible to activate a window without the
    15808         help of the currently active application (which is supposedly
    15809         an initiator of this notification). In this case, this method
    15810         must return a non-zero identifier that represents the
    15811         top-level window of the VM console process. The caller, if it
    15812         represents a currently active process, is responsible to use
    15813         this identifier (in a platform-dependent manner) to perform
    15814         actual window activation.
    15815 
    15816         This method must set @a winId to zero if it has performed all
    15817         actions necessary to complete the request and the console
    15818         window is now active and in foreground, to indicate that no
    15819         further action is required on the caller's side.
     15854      Notification when a call to
     15855      <link to="IMachine::showConsoleWindow"/>
     15856      requests the console window to be activated and brought to
     15857      foreground on the desktop of the host PC.
     15858
     15859      This notification should cause the VM console process to
     15860      perform the requested action as described above. If it is
     15861      impossible to do it at a time of this notification, this
     15862      method should return a failure.
     15863
     15864      Note that many modern window managers on many platforms
     15865      implement some sort of focus stealing prevention logic, so
     15866      that it may be impossible to activate a window without the
     15867      help of the currently active application (which is supposedly
     15868      an initiator of this notification). In this case, this method
     15869      must return a non-zero identifier that represents the
     15870      top-level window of the VM console process. The caller, if it
     15871      represents a currently active process, is responsible to use
     15872      this identifier (in a platform-dependent manner) to perform
     15873      actual window activation.
     15874
     15875      This method must set @a winId to zero if it has performed all
     15876      actions necessary to complete the request and the console
     15877      window is now active and in foreground, to indicate that no
     15878      further action is required on the caller's side.
    1582015879    </desc>
    1582115880    <attribute name="winId" type="long long">
    1582215881      <desc>
    15823          Platform-dependent identifier of the top-level VM console
    15824           window, or zero if this method has performed all actions
    15825           necessary to implement the <i>show window</i> semantics for
    15826           the given platform and/or this VirtualBox front-end.
     15882        Platform-dependent identifier of the top-level VM console
     15883        window, or zero if this method has performed all actions
     15884        necessary to implement the <i>show window</i> semantics for
     15885        the given platform and/or this VirtualBox front-end.
    1582715886      </desc>
    1582815887    </attribute>
    … …  
    1583415893    wsmap="managed" autogen="VBoxEvent" id="OnNATRedirect"
    1583515894    >
    15836    <desc>
     15895    <desc>
    1583715896      Notification when NAT redirect rule added or removed.
    15838    </desc>
    15839      <attribute name="slot"  type="unsigned long" readonly="yes">
    15840        <desc>
    15841          Adapter which NAT attached to.
    15842        </desc>
    15843      </attribute>
    15844      <attribute name="remove"  type="boolean" readonly="yes">
    15845        <desc>
    15846          Whether rule remove or add.
    15847        </desc>
    15848      </attribute>
    15849      <attribute name="name"  type="wstring" readonly="yes">
    15850        <desc>
    15851          Name of the rule.
    15852        </desc>
    15853      </attribute>
    15854      <attribute name="proto"  type="NATProtocol" readonly="yes">
    15855        <desc>
    15856          Protocol (TCP or UDP) of the redirect rule.
    15857        </desc>
    15858      </attribute>
    15859      <attribute name="hostIp"  type="wstring" readonly="yes">
    15860        <desc>
    15861          Host ip address to bind socket on.
    15862        </desc>
    15863      </attribute>
    15864      <attribute name="hostPort"  type="long" readonly="yes">
    15865        <desc>
    15866          Host port to bind socket on.
    15867        </desc>
    15868      </attribute>
    15869      <attribute name="guestIp"  type="wstring" readonly="yes">
    15870        <desc>
    15871          Guest ip address to redirect to.
    15872        </desc>
    15873      </attribute>
    15874      <attribute name="guestPort"  type="long" readonly="yes">
    15875        <desc>
    15876          Guest port to redirect to.
    15877        </desc>
    15878      </attribute>
     15897    </desc>
     15898    <attribute name="slot"  type="unsigned long" readonly="yes">
     15899      <desc>
     15900        Adapter which NAT attached to.
     15901      </desc>
     15902    </attribute>
     15903    <attribute name="remove"  type="boolean" readonly="yes">
     15904      <desc>
     15905        Whether rule remove or add.
     15906      </desc>
     15907    </attribute>
     15908    <attribute name="name"  type="wstring" readonly="yes">
     15909      <desc>
     15910        Name of the rule.
     15911      </desc>
     15912    </attribute>
     15913    <attribute name="proto"  type="NATProtocol" readonly="yes">
     15914      <desc>
     15915        Protocol (TCP or UDP) of the redirect rule.
     15916      </desc>
     15917    </attribute>
     15918    <attribute name="hostIp"  type="wstring" readonly="yes">
     15919      <desc>
     15920        Host ip address to bind socket on.
     15921      </desc>
     15922    </attribute>
     15923    <attribute name="hostPort"  type="long" readonly="yes">
     15924      <desc>
     15925        Host port to bind socket on.
     15926      </desc>
     15927    </attribute>
     15928    <attribute name="guestIp"  type="wstring" readonly="yes">
     15929      <desc>
     15930        Guest ip address to redirect to.
     15931      </desc>
     15932    </attribute>
     15933    <attribute name="guestPort"  type="long" readonly="yes">
     15934      <desc>
     15935        Guest port to redirect to.
     15936      </desc>
     15937    </attribute>
    1587915938  </interface>
    1588015939
    1588115940  <interface
    15882       name="IHostPciDevicePlugEvent" extends="IMachineEvent"
    15883       waitable="yes"
    15884       uuid="EDD4782B-DB74-43A0-B724-2BAA36F039CC"
    15885       wsmap="managed" autogen="VBoxEvent" id="OnHostPciDevicePlug"
     15941    name="IHostPciDevicePlugEvent" extends="IMachineEvent"
     15942    waitable="yes"
     15943    uuid="EDD4782B-DB74-43A0-B724-2BAA36F039CC"
     15944    wsmap="managed" autogen="VBoxEvent" id="OnHostPciDevicePlug"
    1588615945    >
    15887    <desc>
     15946    <desc>
    1588815947      Notification when host PCI device is plugged/unplugged.
    15889    </desc>
    15890 
    15891    <attribute name="plugged" type="boolean" readonly="yes">
     15948    </desc>
     15949
     15950    <attribute name="plugged" type="boolean" readonly="yes">
    1589215951      <desc>
    1589315952        If device successfully plugged or unplugged.
    1589415953      </desc>
    15895    </attribute>
    15896 
    15897    <attribute name="success" type="boolean" readonly="yes">
     15954    </attribute>
     15955
     15956    <attribute name="success" type="boolean" readonly="yes">
    1589815957      <desc>
    1589915958        If operation was successful, if false - 'message' attribute
    1590015959        may be of interest.
    1590115960      </desc>
    15902    </attribute>
    15903 
    15904    <attribute name="attachment" type="IPciDeviceAttachment" readonly="yes">
     15961    </attribute>
     15962
     15963    <attribute name="attachment" type="IPciDeviceAttachment" readonly="yes">
    1590515964      <desc>
    1590615965        Attachment info for this device.
    1590715966      </desc>
    15908    </attribute>
    15909 
    15910    <attribute name="eventContext" type="IEventContext" readonly="yes">
     15967    </attribute>
     15968
     15969    <attribute name="eventContext" type="IEventContext" readonly="yes">
    1591115970      <desc>
    1591215971        Context object, passed into attachHostPciDevice() and
    1591315972        attachHostPciDevice().
    1591415973      </desc>
    15915    </attribute>
    15916 
    15917    <attribute name="message" type="wstring" readonly="yes">
     15974    </attribute>
     15975
     15976    <attribute name="message" type="wstring" readonly="yes">
    1591815977      <desc>
    1591915978        Optional error message.
    … …  
    1592115980    </attribute>
    1592215981
     15982  </interface>
     15983
     15984  <interface
     15985    name="IVBoxSVCUnavailableEvent" extends="IEvent"
     15986    uuid="99f6b352-f5c1-4d15-9c32-939158da8983"
     15987    wsmap="managed" autogen="VBoxEvent" id="OnVBoxSVCUnavailable"
     15988    >
     15989    <desc>
     15990      Notification when VBoxSVC becomes unavailable (due to a crash or similar
     15991      unexpected circumstances).
     15992    </desc>
    1592315993  </interface>
    1592415994
    … …  
    1593116001
    1593216002  <module name="VBoxC" context="InprocServer" threadingModel="Free">
     16003    <class name="VirtualBoxClient" uuid="dd3fc71d-26c0-4fe1-bf6f-67f633265bba"
     16004           namespace="virtualbox.org">
     16005      <interface name="IVirtualBoxClient" default="yes"/>
     16006    </class>
     16007
    1593316008    <class name="Session" uuid="3C02F46D-C9D2-4F11-A384-53F0CF917214"
    1593416009           namespace="virtualbox.org">

  • trunk/src/VBox/Main/include/VirtualBoxClientImpl.h

    r34215 r34416  
    22
    33/** @file
    4  * Header file for the OUSBDevice (IUSBDevice) class, VBoxC.
     4 * Header file for the VirtualBoxClient (IVirtualBoxClient) class, VBoxC.
    55 */
    66
    77/*
    8  * Copyright (C) 2006-2009 Oracle Corporation
     8 * Copyright (C) 2010 Oracle Corporation
    99 *
    1010 * This file is part of VirtualBox Open Source Edition (OSE), as
    … …  
    1717 */
    1818
    19 #ifndef ____H_USBDEVICEIMPL
    20 #define ____H_USBDEVICEIMPL
     19#ifndef ____H_VIRTUALBOXCLIENTIMPL
     20#define ____H_VIRTUALBOXCLIENTIMPL
    2121
    2222#include "VirtualBoxBase.h"
     23#include "EventImpl.h"
    2324
    24 /**
    25  * Object class used for maintaining devices attached to a USB controller.
    26  * Generally this contains much less information.
    27  */
    28 class ATL_NO_VTABLE OUSBDevice :
     25class ATL_NO_VTABLE VirtualBoxClient :
    2926    public VirtualBoxBase,
    30     VBOX_SCRIPTABLE_IMPL(IUSBDevice)
     27    VBOX_SCRIPTABLE_IMPL(IVirtualBoxClient)
     28#ifdef RT_OS_WINDOWS
     29    , public CComCoClass<VirtualBoxClient, &CLSID_VirtualBoxClient>
     30#endif
    3131{
    3232public:
    3333
    34     VIRTUALBOXBASE_ADD_ERRORINFO_SUPPORT(OUSBDevice, IUSBDevice)
     34    VIRTUALBOXBASE_ADD_ERRORINFO_SUPPORT(VirtualBoxClient, IVirtualBoxClient)
    3535
    36     DECLARE_NOT_AGGREGATABLE(OUSBDevice)
     36    DECLARE_CLASSFACTORY_SINGLETON(VirtualBoxClient)
     37
     38    DECLARE_REGISTRY_RESOURCE(IDR_VIRTUALBOX)
     39    DECLARE_NOT_AGGREGATABLE(VirtualBoxClient)
    3740
    3841    DECLARE_PROTECT_FINAL_CONSTRUCT()
    3942
    40     BEGIN_COM_MAP(OUSBDevice)
    41         COM_INTERFACE_ENTRY  (ISupportErrorInfo)
    42         COM_INTERFACE_ENTRY  (IUSBDevice)
    43         COM_INTERFACE_ENTRY2 (IDispatch, IUSBDevice)
     43    BEGIN_COM_MAP(VirtualBoxClient)
     44        COM_INTERFACE_ENTRY2(IDispatch, IVirtualBoxClient)
     45        COM_INTERFACE_ENTRY(ISupportErrorInfo)
     46        COM_INTERFACE_ENTRY(IVirtualBoxClient)
    4447    END_COM_MAP()
    4548
    46     DECLARE_EMPTY_CTOR_DTOR (OUSBDevice)
     49    DECLARE_EMPTY_CTOR_DTOR(VirtualBoxClient)
    4750
    4851    HRESULT FinalConstruct();
    … …  
    5053
    5154    // public initializer/uninitializer for internal purposes only
    52     HRESULT init (IUSBDevice *a_pUSBDevice);
     55    HRESULT init();
    5356    void uninit();
    5457
    5558    // IUSBDevice properties
    56     STDMETHOD(COMGETTER(Id))(BSTR *aId);
    57     STDMETHOD(COMGETTER(VendorId))(USHORT *aVendorId);
    58     STDMETHOD(COMGETTER(ProductId))(USHORT *aProductId);
    59     STDMETHOD(COMGETTER(Revision))(USHORT *aRevision);
    60     STDMETHOD(COMGETTER(Manufacturer))(BSTR *aManufacturer);
    61     STDMETHOD(COMGETTER(Product))(BSTR *aProduct);
    62     STDMETHOD(COMGETTER(SerialNumber))(BSTR *aSerialNumber);
    63     STDMETHOD(COMGETTER(Address))(BSTR *aAddress);
    64     STDMETHOD(COMGETTER(Port))(USHORT *aPort);
    65     STDMETHOD(COMGETTER(Version))(USHORT *aVersion);
    66     STDMETHOD(COMGETTER(PortVersion))(USHORT *aPortVersion);
    67     STDMETHOD(COMGETTER(Remote))(BOOL *aRemote);
    68 
    69     // public methods only for internal purposes
    70     const Guid &id() const { return mData.id; }
     59    STDMETHOD(COMGETTER(VirtualBox))(IVirtualBox **aVirtualBox);
     60    STDMETHOD(COMGETTER(Session))(ISession **aSession);
     61    STDMETHOD(COMGETTER(EventSource))(IEventSource **aEventSource);
    7162
    7263private:
    7364
     65    static DECLCALLBACK(int) SVCWatcherThread(RTTHREAD ThreadSelf, void *pvUser);
     66
    7467    struct Data
    7568    {
    76         Data() : vendorId (0), productId (0), revision (0), port (0),
    77                  version (1), portVersion (1), remote (FALSE) {}
     69        Data()
     70        {}
    7871
    79         /** The UUID of this device. */
    80         const Guid id;
     72        const ComPtr<IVirtualBox> m_pVirtualBox;
     73        const ComObjPtr<EventSource> m_pEventSource;
    8174
    82         /** The vendor id of this USB device. */
    83         const USHORT vendorId;
    84         /** The product id of this USB device. */
    85         const USHORT productId;
    86         /** The product revision number of this USB device.
    87          * (high byte = integer; low byte = decimal) */
    88         const USHORT revision;
    89         /** The Manufacturer string. (Quite possibly NULL.) */
    90         const Bstr manufacturer;
    91         /** The Product string. (Quite possibly NULL.) */
    92         const Bstr product;
    93         /** The SerialNumber string. (Quite possibly NULL.) */
    94         const Bstr serialNumber;
    95         /** The host specific address of the device. */
    96         const Bstr address;
    97         /** The host port number. */
    98         const USHORT port;
    99         /** The major USB version number of the device. */
    100         const USHORT version;
    101         /** The major USB version number of the port the device is attached to. */
    102         const USHORT portVersion;
    103         /** Remote (VRDP) or local device. */
    104         const BOOL remote;
     75        RTTHREAD m_ThreadWatcher;
     76        RTSEMEVENT m_SemEvWatcher;
    10577    };
    10678
    … …  
    10880};
    10981
    110 #endif // ____H_USBDEVICEIMPL
     82#endif // ____H_VIRTUALBOXCLIENTIMPL
    11183/* vi: set tabstop=4 shiftwidth=4 expandtab: */

  • trunk/src/VBox/Main/win/dllmain.cpp

    r33590 r34416  
    2020
    2121#include <SessionImpl.h>
     22#include <VirtualBoxClientImpl.h>
    2223
    2324#include <atlbase.h>
    … …  
    3031BEGIN_OBJECT_MAP(ObjectMap)
    3132    OBJECT_ENTRY(CLSID_Session, Session)
     33    OBJECT_ENTRY(CLSID_VirtualBoxClient, VirtualBoxClient)
    3234END_OBJECT_MAP()
    3335
Note: See TracChangeset for help on using the changeset viewer.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette