Changeset 79050 in vbox for trunk/src/VBox/Main/idl/VirtualBox.xidl

Timestamp:

Jun 8, 2019 3:05:03 AM (5 years ago)

Author:

vboxsync

Message:

Main/GuestImpl: Added OnGuestAdditionsStatusChanged event so the validation kit can more efficiently wait on GAs to come online. bugref:9151

File:

• trunk/src/VBox/Main/idl/VirtualBox.xidl (modified) (3 diffs)

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

@@ -23657 +23657 @@
       </desc>
     </const>
-    <const name="OnGuestMonitorInfoChanged" value="101">
+    <const name="OnGuestAdditionsStatusChanged" value="101">
+      <desc>
+        See <link to="IGuestAdditionsStatusChangedEvent">IGuestAdditionsStatusChangedEvent</link>.
+      </desc>
+    </const>
+    <const name="OnGuestMonitorInfoChanged" value="102">
       <desc>
         See <link to="IGuestMonitorInfoChangedEvent">IGuestMonitorInfoChangedEvent</link>.
       </desc>
     </const>
-    <!-- Last event marker -->
-    <const name="Last" value="102">
+    <!-- End event marker -->
+    <!-- @todo rename to 'End' as it is exclusive (we use 'last' to be inclusive). -->
+    <const name="Last" value="103">
       <desc>
         Must be last event, used for iterations and structures relying on numerical event values.
@@ -25760 +25766 @@
 
   <interface
+    name="IGuestAdditionsStatusChangedEvent" extends="IEvent"
+    uuid="fd1a34ad-0b74-4e2b-ed0f-46222de8a883"
+    wsmap="managed" autogen="VBoxEvent" id="OnGuestAdditionsStatusChanged">
+    <desc>The guest addition status changed.</desc>
+
+    <attribute name="facility" type="AdditionsFacilityType" dir="in">
+      <desc>Facility this event relates to.</desc>
+    </attribute>
+    <attribute name="status" type="AdditionsFacilityStatus" readonly="yes">
+      <desc>The new facility status.</desc>
+    </attribute>
+    <attribute name="runLevel" type="AdditionsRunLevelType" readonly="yes">
+      <desc>The new run level.</desc>
+    </attribute>
+    <attribute name="timestamp" type="long long" readonly="yes">
+      <desc>The millisecond timestamp associated with the event.</desc>
+    </attribute>
+  </interface>
+
+  <interface
     name="IGuestMonitorInfoChangedEvent" extends="IEvent"
     uuid="0b3cdeb2-808e-11e9-b773-133d9330f849"
@@ -25769 +25795 @@
     </attribute>
   </interface>
-
 
   <!--