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

Timestamp:

Jul 9, 2008 9:52:56 AM (17 years ago)

Author:

vboxsync

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

33055

Message:

Main API fix for getting processor speed/description - there's no guarantee that all cpus will stick to same properties forever. So query by cpuId.

File:

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

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

@@ -4805 +4805 @@
   <interface
      name="IHost" extends="$unknown"
-     uuid="a42a480f-d554-4be0-b11c-6c2e54dd1274"
+     uuid="3d864057-ae6b-4d05-9cf7-c341139b6062"
      wsmap="managed"
      >
@@ -4879 +4879 @@
     </attribute>
 
-    <attribute name="processorSpeed" type="unsigned long" readonly="yes">
-      <desc>(Approximate) speed of the host CPU in Megahertz.</desc>
-    </attribute>
-
-    <attribute name="processorDescription" type="wstring" readonly="yes">
-      <desc>Description string of the host CPU.</desc>
-    </attribute>
+    <method name="getProcessorSpeed">
+      <desc>Query the (approximate) maximum speed of a specified host CPU in Megahertz.</desc>
+      <param name="cpuId" type="unsigned long" dir="in">
+        <desc>
+          Identifier of the CPU.
+        </desc>
+      </param>
+      <param name="speed" type="unsigned long" dir="return">
+        <desc>
+          Speed value. 0 is returned if value is not known or @a cpuId is
+          invalid.
+        </desc>
+      </param>
+    </method>
+
+    <method name="getProcessorDescription">
+      <desc>Query the model string of a specified host CPU.</desc>
+      <param name="cpuId" type="unsigned long" dir="in">
+        <desc>
+          Identifier of the CPU.
+        </desc>
+      </param>
+      <param name="description" type="wstring" dir="return">
+        <desc>
+          Model string. A NULL string is returned if value is not known or
+          @a cpuId is invalid.
+        </desc>
+      </param>
+    </method>
 
     <attribute name="memorySize" type="unsigned long" readonly="yes">