Changeset 24403 in vbox

Timestamp:

Nov 5, 2009 5:12:55 PM (16 years ago)

Author:

vboxsync

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

54449

Message:

Main: Added Host::GetProcessorCpuIdLeaf.

Location:

trunk/src/VBox/Main

Files:

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

trunk/src/VBox/Main/HostImpl.cpp

@@ -1004 +1004 @@
     return S_OK;
 }
+
 /**
  * Returns a description string for the host CPU
@@ -1060 +1061 @@
             ReturnComNotImplemented();
     }
+    return S_OK;
+}
+
+/**
+ * Returns the specific CPUID leaf.
+ *
+ * @returns COM status code
+ * @param   aCpuId              The CPU number. Mostly ignored.
+ * @param   aLeaf               The leaf number.
+ * @param   aSubLeaf            The sub-leaf number.
+ * @param   aValEAX             Where to return EAX.
+ * @param   aValEBX             Where to return EBX.
+ * @param   aValECX             Where to return ECX.
+ * @param   aValEDX             Where to return EDX.
+ */
+STDMETHODIMP Host::GetProcessorCpuIdLeaf(ULONG aCpuId, ULONG aLeaf, ULONG aSubLeaf,
+                                         ULONG *aValEAX, ULONG *aValEBX, ULONG *aValECX, ULONG *aValEDX)
+{
+    CheckComArgOutPointerValid(aValEAX);
+    CheckComArgOutPointerValid(aValEBX);
+    CheckComArgOutPointerValid(aValECX);
+    CheckComArgOutPointerValid(aValEDX);
+    // no locking required
+
+    /* Check that the CPU is online. */
+    /** @todo later use RTMpOnSpecific. */
+    if (!RTMpIsCpuOnline(aCpuId))
+        return RTMpIsCpuPresent(aCpuId)
+             ? setError(E_FAIL, tr("CPU no.%u is not present"), aCpuId)
+             : setError(E_FAIL, tr("CPU no.%u is not online"), aCpuId);
+
+    uint32_t uEAX, uEBX, uECX, uEDX;
+    ASMCpuId_Idx_ECX(aLeaf, aSubLeaf, &uEAX, &uEBX, &uECX, &uEDX);
+    *aValEAX = uEAX;
+    *aValEBX = uEBX;
+    *aValECX = uECX;
+    *aValEDX = uEDX;
+
     return S_OK;
 }

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

@@ -5183 +5183 @@
 
         See the Intel and AMD programmer's manuals for detailed information
-        about the cpuid instruction and its leafs.        
+        about the cpuid instruction and its leafs.
         <result name="E_INVALIDARG">
           Invalid id.
@@ -7197 +7197 @@
   <interface
      name="IHost" extends="$unknown"
-     uuid="95522f11-1ecc-443b-9242-3af6b24d430c"
+     uuid="e380cbfc-ae65-4fa6-899e-45ded6b3132a"
      wsmap="managed"
      >
@@ -7304 +7304 @@
         <desc>
           Identifier of the CPU.
+          <note>
+            The current implementation might not necessarily return the
+            description for this exact CPU.
+          </note>
         </desc>
       </param>
@@ -7310 +7314 @@
           Model string. An empty string is returned if value is not known or
           @a cpuId is invalid.
+        </desc>
+      </param>
+    </method>
+
+    <method name="getProcessorCpuIdLeaf">
+      <desc>
+        Returns the CPU cpuid information for the specified leaf.
+      </desc>
+      <param name="cpuId" type="unsigned long" dir="in">
+        <desc>
+          Identifier of the CPU.  The CPU most be online.
+          <note>
+            The current implementation might not necessarily return the
+            description for this exact CPU.
+          </note>
+        </desc>
+      </param>
+      <param name="leaf" type="unsigned long" dir="in">
+        <desc>
+          Cpuid leaf index (eax).
+        </desc>
+      </param>
+      <param name="subLeaf" type="unsigned long" dir="in">
+        <desc>
+          Cpuid leaf sub index (ecx).  This currently only applies to cache
+          information on Intel CPUs.  Use 0 if retriving values for
+          <link to="IMachine::setCpuIdLeaf"/>.
+        </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>

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

@@ -76 +76 @@
     STDMETHOD(GetProcessorDescription)(ULONG cpuId, BSTR *description);
     STDMETHOD(GetProcessorFeature) (ProcessorFeature_T feature, BOOL *supported);
+    STDMETHOD(GetProcessorCpuIdLeaf)(ULONG aCpuId, ULONG aLeaf, ULONG aSubLeaf, ULONG *aValEAX, ULONG *aValEBX, ULONG *aValECX, ULONG *aValEDX);
     STDMETHOD(COMGETTER(MemorySize))(ULONG *size);
     STDMETHOD(COMGETTER(MemoryAvailable))(ULONG *available);