Changeset 71798 in vbox for trunk

Timestamp:

Apr 10, 2018 5:55:52 AM (7 years ago)

Author:

vboxsync

Message:

VMM/HM: Comment.

File:

• trunk/src/VBox/VMM/VMMR3/HM.cpp (modified) (3 diffs)

trunk/src/VBox/VMM/VMMR3/HM.cpp

@@ -582 +582 @@
      * A counter that is decrement each time a PAUSE instruction is executed by the
      * guest. When the counter is 0, a \#VMEXIT is triggered.
+     *
+     * Setting SvmPauseFilterCount to 0 disables pause-filter exiting.
      */
     rc = CFGMR3QueryU16Def(pCfgHm, "SvmPauseFilter", &pVM->hm.s.svm.cPauseFilter, 0);
@@ -587 +589 @@
 
     /** @cfgm{/HM/SvmPauseFilterThreshold, uint16_t, 0}
-     * The pause filter threshold in ticks. When the elapsed time between two
-     * successive PAUSE instructions exceeds SvmPauseFilterThreshold, the PauseFilter
-     * count is reset to its initial value. However, if PAUSE is executed PauseFilter
-     * times within PauseFilterThreshold ticks, a VM-exit will be triggered.
+     * The pause filter threshold in ticks. When the elapsed time (in ticks) between
+     * two successive PAUSE instructions exceeds SvmPauseFilterThreshold, the
+     * PauseFilter count is reset to its initial value. However, if PAUSE is
+     * executed PauseFilter times within PauseFilterThreshold ticks, a VM-exit will
+     * be triggered.
      *
-     * Setting both SvmPauseFilterCount and SvmPauseFilterCount to 0 disables
-     * pause-filter exiting.
+     * Requires SvmPauseFilterCount to be non-zero for pause-filter threshold to be
+     * activated.
      */
     rc = CFGMR3QueryU16Def(pCfgHm, "SvmPauseFilterThreshold", &pVM->hm.s.svm.cPauseFilterThresholdTicks, 0);
@@ -3536 +3539 @@
         /** @todo We need to save SVMNESTEDVMCBCACHE (if pCtx fHMCached is true as we
          *        are in nested-geust execution and the cache contains pristine
-         *        fields that we only restore on #VMEXIT and not on
+         *        fields that we only restore on \#VMEXIT and not on
          *        every exit-to-ring 3. */
     }