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

Timestamp:

Mar 9, 2009 9:34:22 AM (16 years ago)

Author:

vboxsync

Message:

#3551: “Main: Replace remaining collections with safe arrays”
Replaced IUSBDeviceCollection. Reviewed by Christian.

File:

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

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

@@ -5568 +5568 @@
   <interface
      name="IConsole" extends="$unknown"
-     uuid="e3c6d4a1-a935-47ca-b16d-f9e9c496e53e"
+     uuid="3d458cf1-d8aa-4593-84db-41de9e7242d8"
      wsmap="managed"
      >
@@ -5650 +5650 @@
     </attribute>
 
-    <attribute name="USBDevices" type="IUSBDeviceCollection" readonly="yes">
+    <attribute name="USBDevices" type="IUSBDevice" readonly="yes" safearray="yes">
       <desc>
         Collection of USB devices currently attached to the virtual
@@ -6020 +6020 @@
       <param name="device" type="IUSBDevice" dir="return">
         <desc>Detached USB device.</desc>
+      </param>
+    </method>
+
+    <method name="findUSBDeviceByAddress">
+      <desc>
+        Searches for a USB device with the given host address.
+
+        <result name="VBOX_E_OBJECT_NOT_FOUND">
+          Given @c name does not correspond to any USB device.
+        </result>
+
+        <see>IUSBDevice::address</see>
+      </desc>
+      <param name="name" type="wstring" dir="in">
+        <desc>
+          Address of the USB device (as assigned by the host) to
+          search for.
+        </desc>
+      </param>
+      <param name="device" type="IUSBDevice" dir="return">
+        <desc>Found USB device object.</desc>
+      </param>
+    </method>
+
+    <method name="findUSBDeviceById">
+      <desc>
+        Searches for a USB device with the given UUID.
+
+        <result name="VBOX_E_OBJECT_NOT_FOUND">
+          Given @c id does not correspond to any USB device.
+        </result>
+
+        <see>IUSBDevice::id</see>
+      </desc>
+      <param name="id" type="uuid" dir="in">
+        <desc>UUID of the USB device to search for.</desc>
+      </param>
+      <param name="device" type="IUSBDevice" dir="return">
+        <desc>Found USB device object.</desc>
       </param>
     </method>
@@ -10998 +11037 @@
   -->
 
-  <enumerator
-     name="IUSBDeviceEnumerator" type="IUSBDevice"
-     uuid="aefe00f7-eb8a-454b-9ea4-fd5ad93c0e99"
-     />
-
-  <collection
-     name="IUSBDeviceCollection" type="IUSBDevice"
-     enumerator="IUSBDeviceEnumerator"
-     uuid="e31f3248-90dd-4ca2-95f0-6b36042d96a2"
-     readonly="yes"
-     >
-    <method name="findById">
-      <desc>
-        Searches this collection for a USB device with the given UUID.
-        <note>
-          The method returns an error if the given UUID does not
-          correspond to any USB device in the collection.
-        </note>
-        <see>IUSBDevice::id</see>
-      </desc>
-      <param name="id" type="uuid" dir="in">
-        <desc>UUID of the USB device to search for.</desc>
-      </param>
-      <param name="device" type="IUSBDevice" dir="return">
-        <desc>Found USB device object.</desc>
-      </param>
-    </method>
-
-    <method name="findByAddress">
-      <desc>
-        Searches this collection for a USB device with the given
-        host address.
-        <note>
-          The method returns an error if the given address does not
-          correspond to any USB device in the collection.
-        </note>
-        <see>IUSBDevice::address</see>
-      </desc>
-      <param name="name" type="wstring" dir="in">
-        <desc>
-          Address of the USB device (as assigned by the host) to
-          search for.
-        </desc>
-      </param>
-      <param name="device" type="IUSBDevice" dir="return">
-        <desc>Found USB device object.</desc>
-      </param>
-    </method>
-
-  </collection>
-
   <interface
      name="IUSBDevice" extends="$unknown"