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

Timestamp:

Sep 29, 2017 4:13:26 PM (7 years ago)

Author:

vboxsync

Message:

Main,VBoxManage: Changed the CPUID override methods on IMachine to take sub-leaves into account. Currently we do not support non-zero sub-leaves due to VMM, but that can be fixed later.

File:

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

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

@@ -4776 +4776 @@
   <interface
     name="IMachine" extends="$unknown"
-    uuid="f50b24f0-0956-453c-d14c-8c27c683c295"
+    uuid="85cd948e-a71f-4289-281e-0ca7ad48cd89"
     wsmap="managed"
     wrap-hint-server-addinterfaces="IInternalMachineControl"
     wrap-hint-server="manualaddinterfaces"
-    reservedMethods="7" reservedAttributes="9"
+    reservedMethods="6" reservedAttributes="9"
     >
     <!-- Note! This interface is not compatible between 5.0 and 5.1 as it had too many
@@ -6932 +6932 @@
     </method>
 
+    <method name="getCPUIDLeafByOrdinal" const="yes">
+      <desc>
+        Used to enumerate CPUID information override values.
+
+        <result name="E_INVALIDARG">
+          Invalid ordinal number is out of range.
+        </result>
+      </desc>
+      <param name="ordinal" type="unsigned long" dir="in">
+        <desc>
+          The ordinal number of the leaf to get.
+        </desc>
+      </param>
+      <param name="idx" type="unsigned long" dir="out">
+        <desc>
+          CPUID leaf index.
+        </desc>
+      </param>
+      <param name="idxSub" type="unsigned long" dir="out">
+        <desc>
+          CPUID leaf sub-index.
+        </desc>
+      </param>
+      <param name="valEax" type="unsigned long" dir="out">
+        <desc>
+          CPUID leaf value for register eax.
+        </desc>
+      </param>
+      <param name="valEbx" type="unsigned long" dir="out">
+        <desc>
+          CPUID leaf value for register ebx.
+        </desc>
+      </param>
+      <param name="valEcx" type="unsigned long" dir="out">
+        <desc>
+          CPUID leaf value for register ecx.
+        </desc>
+      </param>
+      <param name="valEdx" type="unsigned long" dir="out">
+        <desc>
+          CPUID leaf value for register edx.
+        </desc>
+      </param>
+    </method>
+
     <method name="getCPUIDLeaf" const="yes">
       <desc>
@@ -6937 +6982 @@
 
         Currently supported index values for cpuid:
-        Standard CPUID leafs: 0 - 0xA
-        Extended CPUID leafs: 0x80000000 - 0x8000000A
-
-        See the Intel and AMD programmer's manuals for detailed information
-        about the cpuid instruction and its leafs.
+        Standard CPUID leaves: 0 - 0x1f
+        Extended CPUID leaves: 0x80000000 - 0x8000001f
+        VIA CPUID leaves:      0xc0000000 - 0xc000000f
+
+        See the Intel, AMD and VIA programmer's manuals for detailed information
+        about the CPUID instruction and its leaves.
         <result name="E_INVALIDARG">
-          Invalid id.
-        </result>
-
-      </desc>
-      <param name="id" type="unsigned long" dir="in">
+          Invalid index.
+        </result>
+
+      </desc>
+      <param name="idx" type="unsigned long" dir="in">
         <desc>
           CPUID leaf index.
+        </desc>
+      </param>
+      <param name="idxSub" type="unsigned long" dir="in">
+        <desc>
+          CPUID leaf sub-index (ECX).  Set to 0xffffffff (or 0) if not applicable.
         </desc>
       </param>
@@ -6980 +7031 @@
 
         Currently supported index values for cpuid:
-        Standard CPUID leafs: 0 - 0xA
-        Extended CPUID leafs: 0x80000000 - 0x8000000A
-
-        See the Intel and AMD programmer's manuals for detailed information
-        about the cpuid instruction and its leafs.
+        Standard CPUID leaves: 0 - 0x1f
+        Extended CPUID leaves: 0x80000000 - 0x8000001f
+        VIA CPUID leaves:      0xc0000000 - 0xc000000f
+
+        The subleaf index is only applicable to certain leaves (see manuals as this is
+        subject to change).
+
+        See the Intel, AMD and VIA programmer's manuals for detailed information
+        about the cpuid instruction and its leaves.
 
         Do not use this method unless you know exactly what you're doing. Misuse can lead to
         random crashes inside VMs.
         <result name="E_INVALIDARG">
-          Invalid id.
-        </result>
-
-      </desc>
-      <param name="id" type="unsigned long" dir="in">
+          Invalid index.
+        </result>
+
+      </desc>
+      <param name="idx" type="unsigned long" dir="in">
         <desc>
           CPUID leaf index.
         </desc>
       </param>
+      <param name="idxSub" type="unsigned long" dir="in">
+        <desc>
+          CPUID leaf sub-index (ECX).  Set to 0xffffffff (or 0) if not applicable.
+          The 0xffffffff causes it to remove all other subleaves before adding one
+          with sub-index 0.
+        </desc>
+      </param>
       <param name="valEax" type="unsigned long" dir="in">
         <desc>
@@ -7025 +7087 @@
 
         <result name="E_INVALIDARG">
-          Invalid id.
-        </result>
-
-      </desc>
-      <param name="id" type="unsigned long" dir="in">
+          Invalid index.
+        </result>
+
+      </desc>
+      <param name="idx" type="unsigned long" dir="in">
         <desc>
           CPUID leaf index.
+        </desc>
+      </param>
+      <param name="idxSub" type="unsigned long" dir="in">
+        <desc>
+          CPUID leaf sub-index (ECX).  Set to 0xffffffff (or 0) if not applicable.
+          The 0xffffffff value works like a wildcard.
         </desc>
       </param>