Changeset 45737 in vbox for trunk/src/VBox/VMM

Timestamp:

Apr 25, 2013 6:06:14 PM (12 years ago)

Author:

vboxsync

Message:

doc corrections.

Location:

trunk/src/VBox/VMM

Files:

• VMMSwitcher/LegacyandAMD64.mac (modified) (3 diffs)
• include/HMInternal.h (modified) (2 diffs)

trunk/src/VBox/VMM/VMMSwitcher/LegacyandAMD64.mac

@@ -54 +54 @@
 ; The C interface.
 ; @param    [esp + 04h]  Param 1 - VM handle
-; @param    [esp + 08h]  Param 2 - VMCPU offset
+; @param    [esp + 08h]  Param 2 - Offset from VM::CPUM to the CPUMCPU
+;                                  structure for the calling EMT.
 ;
 BEGINPROC vmmR0ToRawMode
@@ -72 +73 @@
 
     push    ebp
-    mov     ebp, [esp + 12]             ; VMCPU offset
+    mov     ebp, [esp + 12]             ; CPUMCPU offset
 
     ; turn off interrupts
@@ -133 +134 @@
 ; INPUT:
 ;       - edx       virtual address of CPUM structure (valid in host context)
-;       - ebp       offset of the CPUMCPU structure
+;       - ebp       offset of the CPUMCPU structure relative to CPUM.
 ;
 ; USES/DESTROYS:

trunk/src/VBox/VMM/include/HMInternal.h

@@ -251 +251 @@
 
 /**
- * Switcher function, HC to RC.
+ * Switcher function, HC to the special 64-bit RC.
  *
  * @param   pVM             Pointer to the VM.
- * @param   uOffsetVMCPU    VMCPU offset from pVM
+ * @param   offCpumVCpu     Offset from pVM->cpum to pVM->aCpus[idCpu].cpum.
  * @returns Return code indicating the action to take.
  */
-typedef DECLCALLBACK (int) FNHMSWITCHERHC(PVM pVM, uint32_t uOffsetVMCPU);
+typedef DECLCALLBACK(int) FNHMSWITCHERHC(PVM pVM, uint32_t offCpumVCpu);
 /** Pointer to switcher function. */
 typedef FNHMSWITCHERHC *PFNHMSWITCHERHC;
@@ -315 +315 @@
 #if HC_ARCH_BITS == 32 && defined(VBOX_ENABLE_64_BITS_GUESTS) && !defined(VBOX_WITH_HYBRID_32BIT_KERNEL)
     /** 32 to 64 bits switcher entrypoint. */
-    R0PTRTYPE(PFNHMSWITCHERHC) pfnHost32ToGuest64R0;
+    R0PTRTYPE(PFNHMSWITCHERHC)  pfnHost32ToGuest64R0;
 
     /* AMD-V 64 bits vmrun handler */