Changeset 56035 in vbox for trunk/src/VBox/Main/idl

Timestamp:

May 22, 2015 4:03:35 PM (10 years ago)

Author:

vboxsync

Message:

Main/Machine+USBController+StorageController: Mix of deleting useless functionality, fixing of missing sanity checks and adding some additional functionality. The removed functionality is the possibility to specify patters of guest properties which will trigger notifications, which wasn't useful as it is per VM, sabotaging other API clients (e.g. the VM process assumes it gets the notifications it needs). The storage controller setters were lacking a lot of state and consistency sanity checking, which is now fixed. Both the USB and storage controllers can now be renamed (no API client uses this functionality though), all with very pessimistic assumptions (only when the VM is powered off).

File:

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

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

@@ -3580 +3580 @@
   <interface
     name="IInternalMachineControl" extends="$unknown"
-    uuid="2cfec73b-4447-4ff8-bae5-e4306e6197e8"
+    uuid="ec36f437-ad4d-4512-94dd-f4c568143aa7"
     internal="yes"
     wsmap="suppress"
@@ -3807 +3807 @@
         </desc>
       </param>
-      <param name="notify" type="boolean" dir="return">
-        <desc>
-          Returns if a guest property change notification event should be fired.
-        </desc>
-      </param>
     </method>
 
@@ -4170 +4165 @@
   <interface
     name="IMachine" extends="$unknown"
-    uuid="520a0c22-8dbc-458d-b637-31eb078b5526"
+    uuid="6bf820b3-a08f-49a7-ac08-b88efbd3a313"
     wsmap="managed"
     wrap-hint-server-addinterfaces="IInternalMachineControl"
@@ -4800 +4795 @@
     </attribute>
 
-    <attribute name="guestPropertyNotificationPatterns" type="wstring">
-      <desc>
-        A comma-separated list of simple glob patterns. Changes to guest
-        properties whose name matches one of the patterns will generate an
-        <link to="IGuestPropertyChangedEvent"/> signal.
-      </desc>
-    </attribute>
-
     <attribute name="teleporterEnabled" type="boolean">
       <desc>
@@ -6048 +6035 @@
     <method name="getStorageControllerByInstance" const="yes">
       <desc>
-        Returns a storage controller with the given instance number.
+        Returns a storage controller of a specific storage bus
+        with the given instance number.
 
         <result name="VBOX_E_OBJECT_NOT_FOUND">
@@ -6054 +6042 @@
         </result>
       </desc>
+      <param name="connectionType" type="StorageBus" dir="in"/>
       <param name="instance" type="unsigned long" dir="in"/>
       <param name="storageController" type="IStorageController" dir="return"/>
@@ -17804 +17793 @@
   <interface
     name="IUSBController" extends="$unknown"
-    uuid="d2745291-65f7-4d75-9556-38047d802319"
+    uuid="2598fa52-3044-4ff5-8a61-2b09088a9e3c"
     wsmap="managed"
     >
 
-    <attribute name="name" type="wstring" readonly="yes">
+    <attribute name="name" type="wstring">
       <desc>
         The USB Controller name.
@@ -17814 +17803 @@
     </attribute>
 
-    <attribute name="type" type="USBControllerType" readonly="yes">
+    <attribute name="type" type="USBControllerType">
       <desc>
         The USB Controller type.
@@ -19487 +19476 @@
   <interface
     name="IStorageController" extends="$unknown"
-    uuid="a1556333-09b6-46d9-bfb7-fc239b7fbe1e"
+    uuid="802bb9c0-fe71-43ab-b55a-322fdf77358f"
     wsmap="managed"
     >
@@ -19509 +19498 @@
     </desc>
 
-    <attribute name="name" type="wstring" readonly="yes">
+    <attribute name="name" type="wstring">
       <desc>
         Name of the storage controller, as originally specified with