Changeset 23560 in vbox for trunk/src/VBox/Main

Timestamp:

Oct 5, 2009 12:45:09 PM (16 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

53208

Message:

API/SystemProperties: new method to query the maximum instance count for each storage bus

Location:

trunk/src/VBox/Main

Files:

• SystemPropertiesImpl.cpp (modified) (1 diff)
• idl/VirtualBox.xidl (modified) (2 diffs)
• include/SystemPropertiesImpl.h (modified) (1 diff)

trunk/src/VBox/Main/SystemPropertiesImpl.cpp

@@ -469 +469 @@
 }
 
+STDMETHODIMP SystemProperties::GetMaxInstancesOfStorageBus(StorageBus_T aBus, ULONG *aMaxInstances)
+{
+    CheckComArgOutPointerValid(aMaxInstances);
+
+    AutoCaller autoCaller(this);
+    CheckComRCReturnRC(autoCaller.rc());
+
+    /* no need to lock, this is const */
+    switch (aBus)
+    {
+        case StorageBus_SATA:
+        case StorageBus_SCSI:
+        case StorageBus_IDE:
+        case StorageBus_Floppy:
+        {
+            /** @todo raise the limits ASAP, per bus type */
+            *aMaxInstances = 1;
+            break;
+        }
+        default:
+            AssertMsgFailed(("Invalid bus type %d\n", aBus));
+    }
+
+    return S_OK;
+}
+
 STDMETHODIMP SystemProperties::COMGETTER(DefaultMachineFolder) (BSTR *aDefaultMachineFolder)
 {

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

@@ -7238 +7238 @@
      name="ISystemProperties"
      extends="$unknown"
-     uuid="79a8bc4d-24a5-4258-a0a6-8c36f8a68a4b"
+     uuid="4b78105a-d066-4eab-ae48-ccb2c0ba5057"
      wsmap="managed"
      >
@@ -7539 +7539 @@
       <param name="maxPortCount" type="unsigned long" dir="return">
         <desc>The maximum number of ports for the given storage bus.</desc>
+      </param>
+    </method>
+
+    <method name="getMaxInstancesOfStorageBus">
+      <desc>Returns the maximum number of storage bus instances which
+        can be configured for each VM. This corresponds to the number of
+        storage controllers one can have.</desc>
+
+      <param name="bus" type="StorageBus" dir="in">
+        <desc>The storage bus type to get the value for.</desc>
+      </param>
+
+      <param name="maxInstances" type="unsigned long" dir="return">
+        <desc>The maximum number of instances for the given storage bus.</desc>
       </param>
     </method>

trunk/src/VBox/Main/include/SystemPropertiesImpl.h

@@ -98 +98 @@
     STDMETHOD(GetMinPortCountForStorageBus) (StorageBus_T aBus, ULONG *aMinPortCount);
     STDMETHOD(GetMaxPortCountForStorageBus) (StorageBus_T aBus, ULONG *aMaxPortCount);
+    STDMETHOD(GetMaxInstancesOfStorageBus)(StorageBus_T aBus, ULONG *aMaxInstances);
 
     // public methods only for internal purposes