VirtualBox

Changeset 41783 in vbox for trunk/src/VBox/VMM/VMMAll


Ignore:
Timestamp:
Jun 16, 2012 7:24:15 PM (13 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
78601
Message:

Doxygen, comment typos.

Location:
trunk/src/VBox/VMM/VMMAll
Files:
25 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/VBox/VMM/VMMAll/CPUMAllRegs.cpp

    r41774 r41783  
    15391539 *
    15401540 * @returns Number of leafs.
    1541  * @param   pVM         The VM handle.
     1541 * @param   pVM         Pointer to the VM.
    15421542 * @remark  Intended for PATM.
    15431543 */
     
    15521552 *
    15531553 * @returns Number of leafs.
    1554  * @param   pVM         The VM handle.
     1554 * @param   pVM         Pointer to the VM.
    15551555 * @remark  Intended for PATM.
    15561556 */
     
    15651565 *
    15661566 * @returns Number of leafs.
    1567  * @param   pVM         The VM handle.
     1567 * @param   pVM         Pointer to the VM.
    15681568 * @remark  Intended for PATM.
    15691569 */
     
    15771577 * Sets a CPUID feature bit.
    15781578 *
    1579  * @param   pVM             The VM Handle.
     1579 * @param   pVM             Pointer to the VM.
    15801580 * @param   enmFeature      The feature to set.
    15811581 */
     
    17771777 *
    17781778 * @returns boolean for feature presence
    1779  * @param   pVM             The VM Handle.
     1779 * @param   pVM             Pointer to the VM.
    17801780 * @param   enmFeature      The feature to query.
    17811781 */
     
    18221822 * Clears a CPUID feature bit.
    18231823 *
    1824  * @param   pVM             The VM Handle.
     1824 * @param   pVM             Pointer to the VM.
    18251825 * @param   enmFeature      The feature to clear.
    18261826 */
     
    19071907 *
    19081908 * @returns CPU vendor
    1909  * @param   pVM     The VM handle.
     1909 * @param   pVM     Pointer to the VM.
    19101910 */
    19111911VMMDECL(CPUMCPUVENDOR) CPUMGetHostCpuVendor(PVM pVM)
     
    19181918 *
    19191919 * @returns CPU vendor
    1920  * @param   pVM     The VM handle.
     1920 * @param   pVM     Pointer to the VM.
    19211921 */
    19221922VMMDECL(CPUMCPUVENDOR) CPUMGetGuestCpuVendor(PVM pVM)
     
    22982298 * @returns true if supported.
    22992299 * @returns false if not supported.
    2300  * @param   pVM     The VM handle.
     2300 * @param   pVM     Pointer to the VM.
    23012301 */
    23022302VMMDECL(bool) CPUMSupportsFXSR(PVM pVM)
     
    23102310 * @returns true if used.
    23112311 * @returns false if not used.
    2312  * @param   pVM       The VM handle.
     2312 * @param   pVM       Pointer to the VM.
    23132313 */
    23142314VMMDECL(bool) CPUMIsHostUsingSysEnter(PVM pVM)
     
    23222322 * @returns true if used.
    23232323 * @returns false if not used.
    2324  * @param   pVM       The VM handle.
     2324 * @param   pVM       Pointer to the VM.
    23252325 */
    23262326VMMDECL(bool) CPUMIsHostUsingSysCall(PVM pVM)
     
    24172417 * @returns true if they are.
    24182418 * @returns false if not.
    2419  * @param   pVCpu     The VM handle.
     2419 * @param   pVCpu     Pointer to the VM.
    24202420 */
    24212421VMMDECL(bool) CPUMAreHiddenSelRegsValid(PVMCPU pVCpu)
  • trunk/src/VBox/VMM/VMMAll/DBGFAll.cpp

    r35346 r41783  
    3131 *
    3232 * @returns DR7 from the DBGF point of view.
    33  * @param   pVM         The VM handle.
     33 * @param   pVM         Pointer to the VM.
    3434 */
    3535VMMDECL(RTGCUINTREG) DBGFBpGetDR7(PVM pVM)
     
    6262 *
    6363 * @returns DR0 from the DBGF point of view.
    64  * @param   pVM         The VM handle.
     64 * @param   pVM         Pointer to the VM.
    6565 */
    6666VMMDECL(RTGCUINTREG) DBGFBpGetDR0(PVM pVM)
     
    7676 *
    7777 * @returns DR1 from the DBGF point of view.
    78  * @param   pVM         The VM handle.
     78 * @param   pVM         Pointer to the VM.
    7979 */
    8080VMMDECL(RTGCUINTREG) DBGFBpGetDR1(PVM pVM)
     
    9090 *
    9191 * @returns DR2 from the DBGF point of view.
    92  * @param   pVM         The VM handle.
     92 * @param   pVM         Pointer to the VM.
    9393 */
    9494VMMDECL(RTGCUINTREG) DBGFBpGetDR2(PVM pVM)
     
    104104 *
    105105 * @returns DR3 from the DBGF point of view.
    106  * @param   pVM         The VM handle.
     106 * @param   pVM         Pointer to the VM.
    107107 */
    108108VMMDECL(RTGCUINTREG) DBGFBpGetDR3(PVM pVM)
  • trunk/src/VBox/VMM/VMMAll/EMAll.cpp

    r41774 r41783  
    371371 * @retval  VERR_EM_INTERNAL_DISAS_ERROR on DISCoreOneEx failure.
    372372 *
    373  * @param   pVM             The VM handle.
     373 * @param   pVM             Pointer to the VM.
    374374 * @param   pVCpu           The VMCPU handle.
    375375 * @param   pCtxCore        The context core (used for both the mode and instruction).
     
    399399 * @retval  VERR_EM_INTERNAL_DISAS_ERROR on DISCoreOneEx failure.
    400400 *
    401  * @param   pVM             The VM handle.
     401 * @param   pVM             Pointer to the VM.
    402402 * @param   pVCpu           The VMCPU handle.
    403403 * @param   GCPtrInstr      The flat address of the instruction.
     
    478478 * @retval  VERR_*                  Fatal errors.
    479479 *
    480  * @param   pVM         The VM handle.
     480 * @param   pVM         Pointer to the VM.
    481481 * @param   pVCpu       The VMCPU handle.
    482482 * @param   pRegFrame   The register frame.
     
    535535 * @retval  VERR_*                  Fatal errors.
    536536 *
    537  * @param   pVM         The VM handle.
     537 * @param   pVM         Pointer to the VM.
    538538 * @param   pVCpu       The VMCPU handle.
    539539 * @param   pDis        The disassembler cpu state for the instruction to be
     
    586586 *
    587587 * @returns VBox status code.
    588  * @param   pVM         The VM handle.
     588 * @param   pVM         Pointer to the VM.
    589589 * @param   pVCpu       The VMCPU handle.
    590590 * @param   pRegFrame   The register frame.
     
    19681968 *
    19691969 * @returns VBox status code.
    1970  * @param   pVM         The VM handle.
     1970 * @param   pVM         Pointer to the VM.
    19711971 * @param   pVCpu       The VMCPU handle.
    19721972 * @param   pRegFrame   The register frame.
     
    20422042 *
    20432043 * @returns VBox status code.
    2044  * @param   pVM         The VM handle.
     2044 * @param   pVM         Pointer to the VM.
    20452045 * @param   pVCpu       The VMCPU handle.
    20462046 * @param   pRegFrame   The register frame.
     
    20802080 *
    20812081 * @returns VBox status code.
    2082  * @param   pVM         The VM handle.
     2082 * @param   pVM         Pointer to the VM.
    20832083 * @param   pVCpu       The VMCPU handle.
    20842084 * @param   pRegFrame   The register frame.
     
    21132113 *
    21142114 * @returns VBox status code.
    2115  * @param   pVM         The VM handle.
     2115 * @param   pVM         Pointer to the VM.
    21162116 * @param   pVCpu       The VMCPU handle.
    21172117 *
     
    21402140 *
    21412141 * @returns VBox status code.
    2142  * @param   pVM         The VM handle.
     2142 * @param   pVM         Pointer to the VM.
    21432143 * @param   pVCpu       The VMCPU handle.
    21442144 * @param   pRegFrame   The register frame.
     
    22792279 *
    22802280 * @returns VBox status code.
    2281  * @param   pVM         The VM handle.
     2281 * @param   pVM         Pointer to the VM.
    22822282 * @param   pVCpu       The VMCPU handle.
    22832283 * @param   pRegFrame   The register frame.
     
    23122312 *
    23132313 * @returns VBox status code.
    2314  * @param   pVM         The VM handle.
     2314 * @param   pVM         Pointer to the VM.
    23152315 * @param   pVCpu       The VMCPU handle.
    23162316 * @param   pRegFrame   The register frame.
     
    24312431 *
    24322432 * @returns VBox status code.
    2433  * @param   pVM         The VM handle.
     2433 * @param   pVM         Pointer to the VM.
    24342434 * @param   pVCpu       The VMCPU handle.
    24352435 * @param   pRegFrame   The register frame.
     
    24712471 *
    24722472 * @returns VBox status code.
    2473  * @param   pVM         The VM handle.
     2473 * @param   pVM         Pointer to the VM.
    24742474 * @param   pVCpu       The VMCPU handle.
    24752475 * @param   pRegFrame   The register frame.
     
    26602660 *
    26612661 * @returns VBox status code.
    2662  * @param   pVM         The VM handle.
     2662 * @param   pVM         Pointer to the VM.
    26632663 * @param   pVCpu       The VMCPU handle.
    26642664 * @param   pRegFrame   The register frame.
     
    26862686 *
    26872687 * @returns VBox status code.
    2688  * @param   pVM         The VM handle.
     2688 * @param   pVM         Pointer to the VM.
    26892689 * @param   pVCpu       The VMCPU handle.
    26902690 * @param   pCtx        The CPU context.
     
    27292729 *
    27302730 * @returns VBox status code.
    2731  * @param   pVM         The VM handle.
     2731 * @param   pVM         Pointer to the VM.
    27322732 * @param   pVCpu       The VMCPU handle.
    27332733 * @param   pRegFrame   The register frame.
     
    29442944 *
    29452945 * @returns VBox status code.
    2946  * @param   pVM         The VM handle.
     2946 * @param   pVM         Pointer to the VM.
    29472947 * @param   pVCpu       The VMCPU handle.
    29482948 * @param   pRegFrame   The register frame.
     
    29892989 *
    29902990 * @returns VBox status code.
    2991  * @param   pVM         The VM handle.
     2991 * @param   pVM         Pointer to the VM.
    29922992 * @param   pVCpu       The VMCPU handle.
    29932993 * @param   pRegFrame   The register frame.
  • trunk/src/VBox/VMM/VMMAll/IEMAllCImpl.cpp.h

    r40396 r41783  
    23982398    }
    23992399
    2400     /* The the base and limit. */
     2400    /* The base and limit. */
    24012401    uint64_t u64Base;
    24022402    uint32_t cbLimit = X86DESC_LIMIT(Desc.Legacy);
  • trunk/src/VBox/VMM/VMMAll/IOMAll.cpp

    r41744 r41783  
    10431043 * Fress an MMIO range after the reference counter has become zero.
    10441044 *
    1045  * @param   pVM                 The VM handle.
     1045 * @param   pVM                 Pointer to the VM.
    10461046 * @param   pRange              The range to free.
    10471047 */
  • trunk/src/VBox/VMM/VMMAll/IOMAllMMIO.cpp

    r41739 r41783  
    8585 *          VINF_IOM_R3_MMIO_READ may be returned.
    8686 *
    87  * @param   pVM                 The VM handle.
     87 * @param   pVM                 Pointer to the VM.
    8888 * @param   pRange              The range to write to.
    8989 * @param   GCPhys              The physical address to start writing.
     
    286286 *          VINF_IOM_R3_MMIO_WRITE may be returned.
    287287 *
    288  * @param   pVM                 The VM handle.
     288 * @param   pVM                 Pointer to the VM.
    289289 * @param   pRange              The range to read from.
    290290 * @param   GCPhys              The physical address to start reading.
  • trunk/src/VBox/VMM/VMMAll/MMAll.cpp

    r41777 r41783  
    3636 * @returns Pointer to the corresponding lookup record.
    3737 * @returns NULL on failure.
    38  * @param   pVM     The VM handle.
     38 * @param   pVM     Pointer to the VM.
    3939 * @param   R3Ptr   The host context ring-3 address to lookup.
    4040 * @param   poff    Where to store the offset into the HMA memory chunk.
     
    9696 * @returns Pointer to the corresponding lookup record.
    9797 * @returns NULL on failure.
    98  * @param   pVM     The VM handle.
     98 * @param   pVM     Pointer to the VM.
    9999 * @param   R0Ptr   The host context ring-0 address to lookup.
    100100 * @param   poff    Where to store the offset into the HMA memory chunk.
     
    158158 * @returns Pointer to the corresponding lookup record.
    159159 * @returns NULL on failure.
    160  * @param   pVM     The VM handle.
     160 * @param   pVM     Pointer to the VM.
    161161 * @param   RCPtr   The raw-mode context address to lookup.
    162162 * @param   poff    Where to store the offset into the HMA memory chunk.
     
    203203 * @returns Pointer to the corresponding lookup record.
    204204 * @returns NULL on failure.
    205  * @param   pVM     The VM handle.
     205 * @param   pVM     Pointer to the VM.
    206206 * @param   pv      The current context address to lookup.
    207207 * @param   poff    Where to store the offset into the HMA memory chunk.
     
    280280 *
    281281 * @returns the raw-mode context base address.
    282  * @param   pVM         The the VM handle.
     282 * @param   pVM         Pointer to the VM.
    283283 * @param   pLookup     The HMA lookup record.
    284284 * @param   off         The offset into the HMA memory chunk.
     
    294294 *
    295295 * @returns the guest context base address.
    296  * @param   pVM         The the VM handle.
     296 * @param   pVM         Pointer to the VM.
    297297 * @param   pLookup     The HMA lookup record.
    298298 * @param   off         The offset into the HMA memory chunk.
  • trunk/src/VBox/VMM/VMMAll/MMAllHyper.cpp

    r41777 r41783  
    154154 * This might call back to Ring-3 in order to deal with lock contention in GC and R3.
    155155 *
    156  * @param   pVM     The VM handle.
     156 * @param   pVM     Pointer to the VM.
    157157 */
    158158static int mmHyperLock(PVM pVM)
     
    179179 * Unlocks the hypervisor heap.
    180180 *
    181  * @param   pVM     The VM handle.
     181 * @param   pVM     Pointer to the VM.
    182182 */
    183183static void mmHyperUnlock(PVM pVM)
  • trunk/src/VBox/VMM/VMMAll/PATMAll.cpp

    r41737 r41783  
    207207 *
    208208 * @returns The eflags.
    209  * @param   pVM         The VM handle.
     209 * @param   pVM         Pointer to the VM.
    210210 * @param   pCtxCore    The context core.
    211211 */
     
    222222 * This is a worker for CPUMRawSetEFlags().
    223223 *
    224  * @param   pVM         The VM handle.
     224 * @param   pVM         Pointer to the VM.
    225225 * @param   pCtxCore    The context core.
    226226 * @param   efl         The new EFLAGS value.
     
    291291 * @returns false if it's disabled.
    292292 *
    293  * @param   pVM         The VM handle.
     293 * @param   pVM         Pointer to the VM.
    294294 */
    295295VMMDECL(bool) PATMAreInterruptsEnabled(PVM pVM)
     
    306306 * @returns false if it's disabled.
    307307 *
    308  * @param   pVM         The VM handle.
     308 * @param   pVM         Pointer to the VM.
    309309 * @param   pCtxCore    CPU context
    310310 */
     
    346346 * @returns VBox status
    347347 *
    348  * @param   pVM         The VM handle.
     348 * @param   pVM         Pointer to the VM.
    349349 * @param   pInstrGC    Instruction pointer
    350350 * @param   pOpcode     Original instruction opcode (out, optional)
     
    373373 * @returns VBox status
    374374 *
    375  * @param   pVM         The VM handle.
     375 * @param   pVM         Pointer to the VM.
    376376 * @param   pCtxCore    The relevant core context.
    377377 * @param   pCpu        Disassembly context
  • trunk/src/VBox/VMM/VMMAll/PDMAll.cpp

    r40907 r41783  
    102102 * @param   pVM             VM handle.
    103103 * @param   u8Irq           The IRQ line.
    104  * @param   u8Level         The new level. 
    105  * @param   uTagSrc         The IRQ tag and source tracer ID. 
     104 * @param   u8Level         The new level.
     105 * @param   uTagSrc         The IRQ tag and source tracer ID.
    106106 */
    107107VMMDECL(int) PDMIsaSetIrq(PVM pVM, uint8_t u8Irq, uint8_t u8Level, uint32_t uTagSrc)
     
    160160 * @param   u8Irq           The IRQ line.
    161161 * @param   u8Level         The new level.
    162  * @param   uTagSrc         The IRQ tag and source tracer ID. 
     162 * @param   uTagSrc         The IRQ tag and source tracer ID.
    163163 */
    164164VMM_INT_DECL(int) PDMIoApicSetIrq(PVM pVM, uint8_t u8Irq, uint8_t u8Level, uint32_t uTagSrc)
     
    182182 * @param   GCAddr          Request address.
    183183 * @param   u8Value         Request value.
    184  * @param   uTagSrc         The IRQ tag and source tracer ID. 
     184 * @param   uTagSrc         The IRQ tag and source tracer ID.
    185185 */
    186186VMM_INT_DECL(int) PDMIoApicSendMsi(PVM pVM, RTGCPHYS GCAddr, uint32_t uValue, uint32_t uTagSrc)
     
    369369 * This might call back to Ring-3 in order to deal with lock contention in GC and R3.
    370370 *
    371  * @param   pVM     The VM handle.
     371 * @param   pVM     Pointer to the VM.
    372372 */
    373373void pdmLock(PVM pVM)
     
    389389 * @returns VINF_SUCCESS on success.
    390390 * @returns rc if we're in GC or R0 and can't get the lock.
    391  * @param   pVM     The VM handle.
     391 * @param   pVM     Pointer to the VM.
    392392 * @param   rc      The RC to return in GC or R0 when we can't get the lock.
    393393 */
     
    401401 * Unlocks PDM.
    402402 *
    403  * @param   pVM     The VM handle.
     403 * @param   pVM     Pointer to the VM.
    404404 */
    405405void pdmUnlock(PVM pVM)
  • trunk/src/VBox/VMM/VMMAll/PGMAll.cpp

    r41462 r41783  
    5656typedef struct PGMHVUSTATE
    5757{
    58     /** The VM handle. */
     58    /** Pointer to the VM. */
    5959    PVM         pVM;
    60     /** The VMCPU handle. */
     60    /** Pointer to the VMCPU. */
    6161    PVMCPU      pVCpu;
    6262    /** The todo flags. */
     
    523523 * @returns NULL if not
    524524 *
    525  * @param   pVM         The VM handle.
     525 * @param   pVM         Pointer to the VM.
    526526 * @param   GCPtr       The guest context pointer.
    527527 */
     
    800800 *
    801801 * @returns VBox status code (appropriate for trap handling and GC return).
    802  * @param   pVM         The VM handle.
     802 * @param   pVM         Pointer to the VM.
    803803 * @param   pVCpu       VMCPU handle.
    804804 * @param   pRegFrame   Register frame.
     
    17151715 * Gets the current CR3 register value for the HC intermediate memory context.
    17161716 * @returns CR3 value.
    1717  * @param   pVM         The VM handle.
     1717 * @param   pVM         Pointer to the VM.
    17181718 */
    17191719VMMDECL(RTHCPHYS) PGMGetInterHCCR3(PVM pVM)
     
    17471747 * Gets the current CR3 register value for the RC intermediate memory context.
    17481748 * @returns CR3 value.
    1749  * @param   pVM         The VM handle.
     1749 * @param   pVM         Pointer to the VM.
    17501750 * @param   pVCpu       VMCPU handle.
    17511751 */
     
    17791779 * Gets the CR3 register value for the 32-Bit intermediate memory context.
    17801780 * @returns CR3 value.
    1781  * @param   pVM         The VM handle.
     1781 * @param   pVM         Pointer to the VM.
    17821782 */
    17831783VMMDECL(RTHCPHYS) PGMGetInter32BitCR3(PVM pVM)
     
    17901790 * Gets the CR3 register value for the PAE intermediate memory context.
    17911791 * @returns CR3 value.
    1792  * @param   pVM         The VM handle.
     1792 * @param   pVM         Pointer to the VM.
    17931793 */
    17941794VMMDECL(RTHCPHYS) PGMGetInterPaeCR3(PVM pVM)
     
    18011801 * Gets the CR3 register value for the AMD64 intermediate memory context.
    18021802 * @returns CR3 value.
    1803  * @param   pVM         The VM handle.
     1803 * @param   pVM         Pointer to the VM.
    18041804 */
    18051805VMMDECL(RTHCPHYS) PGMGetInterAmd64CR3(PVM pVM)
     
    22112211 *
    22122212 * @returns The current paging mode.
    2213  * @param   pVM             The VM handle.
     2213 * @param   pVM             Pointer to the VM.
    22142214 */
    22152215VMMDECL(PGMMODE) PGMGetHostMode(PVM pVM)
     
    23302330 *
    23312331 * @returns bool locked/not locked
    2332  * @param   pVM         The VM handle.
     2332 * @param   pVM         Pointer to the VM.
    23332333 */
    23342334VMMDECL(bool) PGMHasDirtyPages(PVM pVM)
     
    23422342 *
    23432343 * @returns bool owner/not owner
    2344  * @param   pVM         The VM handle.
     2344 * @param   pVM         Pointer to the VM.
    23452345 */
    23462346VMMDECL(bool) PGMIsLockOwner(PVM pVM)
     
    23542354 *
    23552355 * @returns VBox status code.
    2356  * @param   pVM             The VM handle.
     2356 * @param   pVM             Pointer to the VM.
    23572357 * @param   fUseLargePages  Use/not use large pages
    23582358 */
     
    23702370 *
    23712371 * @returns VBox status code
    2372  * @param   pVM         The VM handle.
     2372 * @param   pVM         Pointer to the VM.
    23732373 */
    23742374int pgmLock(PVM pVM)
     
    23882388 *
    23892389 * @returns VBox status code
    2390  * @param   pVM         The VM handle.
     2390 * @param   pVM         Pointer to the VM.
    23912391 */
    23922392void pgmUnlock(PVM pVM)
     
    24052405 *
    24062406 * @returns VBox status code.
    2407  * @param   pVM         The VM handle.
     2407 * @param   pVM         Pointer to the VM.
    24082408 * @param   pVCpu       The current CPU.
    24092409 * @param   GCPhys      The guest physical address of the page to map.  The
     
    26042604 *
    26052605 * @returns Number of conflicts.
    2606  * @param   pVM     The VM handle.
     2606 * @param   pVM     Pointer to the VM.
    26072607 */
    26082608VMMDECL(unsigned) PGMAssertNoMappingConflicts(PVM pVM)
     
    26482648 *
    26492649 * @returns Number of conflicts.
    2650  * @param   pVM     The VM handle.
     2650 * @param   pVM     Pointer to the VM.
    26512651 * @param   pVCpu   The VMCPU handle.
    26522652 * @param   cr3     The current guest CR3 register value.
  • trunk/src/VBox/VMM/VMMAll/PGMAllBth.h

    r41774 r41783  
    15111511 * Modifies a shadow PTE to account for access handlers.
    15121512 *
    1513  * @param   pVM         The VM handle.
     1513 * @param   pVM         Pointer to the VM.
    15141514 * @param   pPage       The page in question.
    15151515 * @param   fPteSrc     The shadowed flags of the source PTE.  Must include the
     
    18761876     * - In the guest SMP case we could have blocked while another VCPU reused
    18771877     *   this page table.
    1878      * - With W7-64 we may also take this path when the the A bit is cleared on
     1878     * - With W7-64 we may also take this path when the A bit is cleared on
    18791879     *   higher level tables (PDPE/PML4E).  The guest does not invalidate the
    18801880     *   relevant TLB entries.  If we're write monitoring any page mapped by
  • trunk/src/VBox/VMM/VMMAll/PGMAllHandler.cpp

    r41777 r41783  
    199199 * @retval  VINF_PGM_SYNC_CR3 when the shadow PTs could be updated because
    200200 *          the guest page aliased or/and mapped by multiple PTs. FFs set.
    201  * @param   pVM     The VM handle.
     201 * @param   pVM     Pointer to the VM.
    202202 * @param   pCur    The physical handler.
    203203 * @param   pRam    The RAM range.
     
    474474 * @returns VBox status code.
    475475 * @retval  VINF_SUCCESS when shadow PTs was successfully updated.
    476  * @param   pVM     The VM handle.
     476 * @param   pVM     Pointer to the VM.
    477477 * @param   pCur    The physical handler.
    478478 *
     
    13231323 *
    13241324 * @returns VBox status code
    1325  * @param   pVM         The VM handle.
     1325 * @param   pVM         Pointer to the VM.
    13261326 * @param   GCPhys      GC physical address to search for.
    13271327 * @param   ppVirt      Where to store the pointer to the virtual handler structure.
     
    13641364 * aliases where the two ranges match 100%.
    13651365 *
    1366  * @param   pVM             The VM handle.
     1366 * @param   pVM             Pointer to the VM.
    13671367 * @param   pPhys2Virt      The node we failed insert.
    13681368 */
     
    14151415 * @returns 0
    14161416 * @param   pNode   Pointer to a PGMVIRTHANDLER.
    1417  * @param   pvUser  The VM handle.
     1417 * @param   pvUser  Pointer to the VM.
    14181418 */
    14191419DECLCALLBACK(int) pgmHandlerVirtualResetOne(PAVLROGCPTRNODECORE pNode, void *pvUser)
     
    15301530    /** Number of errors. */
    15311531    unsigned    cErrors;
    1532     /** The VM handle. */
     1532    /** Pointer to the VM. */
    15331533    PVM         pVM;
    15341534} PGMAHAFIS, *PPGMAHAFIS;
     
    16791679 *
    16801680 * @returns Number of mismatches.
    1681  * @param   pVM     The VM handle.
     1681 * @param   pVM     Pointer to the VM.
    16821682 */
    16831683VMMDECL(unsigned) PGMAssertHandlerAndFlagsInSync(PVM pVM)
  • trunk/src/VBox/VMM/VMMAll/PGMAllMap.cpp

    r38325 r41783  
    217217 *
    218218 * @returns VINF_SUCCESS, VERR_PAGE_NOT_PRESENT or VERR_NOT_FOUND.
    219  * @param   pVM                 The VM handle.
     219 * @param   pVM                 Pointer to the VM.
    220220 * @param   GCPtr               The page address.
    221221 * @param   pfFlags             Where to return the flags.  Optional.
     
    265265 * Sets all PDEs involved with the mapping in the shadow page table.
    266266 *
    267  * @param   pVM         The VM handle.
     267 * @param   pVM         Pointer to the VM.
    268268 * @param   pMap        Pointer to the mapping in question.
    269269 * @param   iNewPDE     The index of the 32-bit PDE corresponding to the base of the mapping.
     
    417417 * Clears all PDEs involved with the mapping in the shadow page table.
    418418 *
    419  * @param   pVM             The VM handle.
     419 * @param   pVM             Pointer to the VM.
    420420 * @param   pShwPageCR3     CR3 root page
    421421 * @param   pMap            Pointer to the mapping in question.
     
    547547 * Clears all PDEs involved with the mapping in the shadow page table.
    548548 *
    549  * @param   pVM         The VM handle.
     549 * @param   pVM         Pointer to the VM.
    550550 * @param   pVCpu       The VMCPU handle.
    551551 * @param   pShwPageCR3 CR3 root page
  • trunk/src/VBox/VMM/VMMAll/PGMAllPhys.cpp

    r41736 r41783  
    5757 *
    5858 * @returns VBox status code (appropriate for trap handling and GC return).
    59  * @param   pVM         The VM handle.
     59 * @param   pVM         Pointer to the VM.
    6060 * @param   uErrorCode  CPU Error code.
    6161 * @param   pRegFrame   Trap register frame.
     
    7676 *
    7777 * @returns VBox status code (appropriate for trap handling and GC return).
    78  * @param   pVM         The VM handle.
     78 * @param   pVM         Pointer to the VM.
    7979 * @param   uErrorCode  CPU Error code.
    8080 * @param   pRegFrame   Trap register frame.
     
    151151 * Invalidates the RAM range TLBs.
    152152 *
    153  * @param   pVM                 The VM handle.
     153 * @param   pVM                 Pointer to the VM.
    154154 */
    155155void pgmPhysInvalidRamRangeTlbs(PVM pVM)
     
    346346 * @returns true if valid.
    347347 * @returns false if invalid.
    348  * @param   pVM     The VM handle.
     348 * @param   pVM     Pointer to the VM.
    349349 * @param   GCPhys  The physical address to validate.
    350350 */
     
    362362 * @returns true if normal.
    363363 * @returns false if invalid, ROM, MMIO or reserved page.
    364  * @param   pVM     The VM handle.
     364 * @param   pVM     Pointer to the VM.
    365365 * @param   GCPhys  The physical address to check.
    366366 */
     
    382382 *          GC physical address.
    383383 *
    384  * @param   pVM     The VM handle.
     384 * @param   pVM     Pointer to the VM.
    385385 * @param   GCPhys  The GC physical address to convert.
    386386 * @param   pHCPhys Where to store the HC physical address on success.
     
    401401 * Invalidates all page mapping TLBs.
    402402 *
    403  * @param   pVM     The VM handle.
     403 * @param   pVM     Pointer to the VM.
    404404 */
    405405void pgmPhysInvalidatePageMapTLB(PVM pVM)
     
    426426 * Invalidates a page mapping TLB entry
    427427 *
    428  * @param   pVM     The VM handle.
     428 * @param   pVM     Pointer to the VM.
    429429 * @param   GCPhys  GCPhys entry to flush
    430430 */
     
    462462 * @retval  VERR_EM_NO_MEMORY if we're really out of memory.
    463463 *
    464  * @param   pVM     The VM handle.
     464 * @param   pVM     Pointer to the VM.
    465465 *
    466466 * @remarks Must be called from within the PGM critical section. It may
     
    549549 * @todo    Propagate VERR_EM_NO_MEMORY up the call tree.
    550550 *
    551  * @param   pVM         The VM handle.
     551 * @param   pVM         Pointer to the VM.
    552552 * @param   pPage       The physical page tracking structure. This will
    553553 *                      be modified on success.
     
    705705 * @todo    Propagate VERR_EM_NO_MEMORY up the call tree.
    706706 *
    707  * @param   pVM         The VM handle.
     707 * @param   pVM         Pointer to the VM.
    708708 * @param   GCPhys      The address of the page.
    709709 *
     
    794794 * @retval  VERR_PGM_INVALID_LARGE_PAGE_RANGE if it can't be reused
    795795 *
    796  * @param   pVM         The VM handle.
     796 * @param   pVM         Pointer to the VM.
    797797 * @param   GCPhys      The address of the page.
    798798 * @param   pLargePage  Page structure of the base page
     
    855855 * @returns VBox strict status code.
    856856 *
    857  * @param   pVM         The VM handle.
     857 * @param   pVM         Pointer to the VM.
    858858 * @param   pPage       The physical page tracking structure.
    859859 *
     
    879879 * @retval  VERR_PGM_PHYS_PAGE_RESERVED it it's a valid page but has no physical backing.
    880880 *
    881  * @param   pVM         The VM handle.
     881 * @param   pVM         Pointer to the VM.
    882882 * @param   pPage       The physical page tracking structure.
    883883 * @param   GCPhys      The address of the page.
     
    923923 * @returns VBox status code.
    924924 *
    925  * @param   pVM         The VM handle.
     925 * @param   pVM         Pointer to the VM.
    926926 * @param   idPage      The Page ID.
    927927 * @param   HCPhys      The physical address (for RC).
     
    10021002 * @retval  VERR_PGM_PHYS_PAGE_RESERVED it it's a valid page but has no physical backing.
    10031003 *
    1004  * @param   pVM         The VM handle.
     1004 * @param   pVM         Pointer to the VM.
    10051005 * @param   pPage       The physical page tracking structure.
    10061006 * @param   GCPhys      The address of the page.
     
    11281128 * @retval  VERR_PGM_PHYS_PAGE_RESERVED it it's a valid page but has no physical backing.
    11291129 *
    1130  * @param   pVM         The VM handle.
     1130 * @param   pVM         Pointer to the VM.
    11311131 * @param   pPage       The physical page tracking structure.
    11321132 * @param   GCPhys      The address of the page.
     
    11631163 * @retval  VERR_PGM_PHYS_PAGE_RESERVED it it's a valid page but has no physical backing.
    11641164 *
    1165  * @param   pVM         The VM handle.
     1165 * @param   pVM         Pointer to the VM.
    11661166 * @param   pPage       The physical page tracking structure. Must be in the
    11671167 *                      allocated state.
     
    11921192 * @retval  VERR_PGM_PHYS_PAGE_RESERVED it it's a valid page but has no physical backing.
    11931193 *
    1194  * @param   pVM         The VM handle.
     1194 * @param   pVM         Pointer to the VM.
    11951195 * @param   pPage       The physical page tracking structure.
    11961196 * @param   GCPhys      The address of the page.
     
    12441244 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS if it's not a valid physical address.
    12451245 *
    1246  * @param   pVM         The VM handle.
     1246 * @param   pVM         Pointer to the VM.
    12471247 * @param   pPage       Pointer to the PGMPAGE structure corresponding to
    12481248 *                      GCPhys.
     
    13011301 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS if it's not a valid physical address.
    13021302 *
    1303  * @param   pVM         The VM handle.
     1303 * @param   pVM         Pointer to the VM.
    13041304 * @param   GCPhys      The guest physical address of the page that should be mapped.
    13051305 * @param   pPage       Pointer to the PGMPAGE structure for the page.
     
    13551355 * Locks a page mapping for writing.
    13561356 *
    1357  * @param   pVM                 The VM handle.
     1357 * @param   pVM                 Pointer to the VM.
    13581358 * @param   pPage               The page.
    13591359 * @param   pTlbe               The mapping TLB entry for the page.
     
    13881388 * Locks a page mapping for reading.
    13891389 *
    1390  * @param   pVM                 The VM handle.
     1390 * @param   pVM                 Pointer to the VM.
    13911391 * @param   pPage               The page.
    13921392 * @param   pTlbe               The mapping TLB entry for the page.
     
    14301430 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS if it's not a valid physical address.
    14311431 *
    1432  * @param   pVM         The VM handle.
     1432 * @param   pVM         Pointer to the VM.
    14331433 * @param   GCPhys      The guest physical address of the page that should be mapped.
    14341434 * @param   pPage       Pointer to the PGMPAGE structure for the page.
     
    14941494 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS if it's not a valid physical address.
    14951495 *
    1496  * @param   pVM         The VM handle.
     1496 * @param   pVM         Pointer to the VM.
    14971497 * @param   GCPhys      The guest physical address of the page that should be mapped.
    14981498 * @param   pPage       Pointer to the PGMPAGE structure for the page.
     
    15531553 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS if it's not a valid physical address.
    15541554 *
    1555  * @param   pVM         The VM handle.
     1555 * @param   pVM         Pointer to the VM.
    15561556 * @param   GCPhys      The guest physical address of the page that should be
    15571557 *                      mapped.
     
    16571657 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS if it's not a valid physical address.
    16581658 *
    1659  * @param   pVM         The VM handle.
     1659 * @param   pVM         Pointer to the VM.
    16601660 * @param   GCPhys      The guest physical address of the page that should be
    16611661 *                      mapped.
     
    18141814 * PGMPhysGCPtr2CCPtr and PGMPhysGCPtr2CCPtrReadOnly.
    18151815 *
    1816  * @param   pVM         The VM handle.
     1816 * @param   pVM         Pointer to the VM.
    18171817 * @param   pLock       The lock structure initialized by the mapping function.
    18181818 */
     
    18891889 * pgmPhysGCPhys2CCPtrInternalReadOnly.
    18901890 *
    1891  * @param   pVM         The VM handle.
     1891 * @param   pVM         Pointer to the VM.
    18921892 * @param   pLock       The lock structure initialized by the mapping function.
    18931893 *
     
    19121912 *          a dynamic ram chunk boundary
    19131913 *
    1914  * @param   pVM         The VM handle.
     1914 * @param   pVM         Pointer to the VM.
    19151915 * @param   GCPhys      The GC physical address to convert.
    19161916 * @param   pR3Ptr      Where to store the R3 pointer on success.
     
    19571957 *          a dynamic ram chunk boundary
    19581958 *
    1959  * @param   pVM         The VM handle.
     1959 * @param   pVM         Pointer to the VM.
    19601960 * @param   GCPhys      The GC physical address to convert.
    19611961 * @param   pR3Ptr      Where to store the R3 pointer on success.  This may or
     
    20342034 * Cache PGMPhys memory access
    20352035 *
    2036  * @param   pVM             The VM handle.
     2036 * @param   pVM             Pointer to the VM.
    20372037 * @param   pCache          Cache structure pointer
    20382038 * @param   GCPhys          GC physical address
     
    20672067 * @retval  VERR_PGM_PHYS_WR_HIT_HANDLER in R0 and GC, NEVER in R3.
    20682068 *
    2069  * @param   pVM         The VM handle.
     2069 * @param   pVM         Pointer to the VM.
    20702070 * @param   pPage       The page descriptor.
    20712071 * @param   GCPhys      The physical address to start reading at.
     
    21992199 * @retval  VERR_PGM_PHYS_WR_HIT_HANDLER in R0 and GC, NEVER in R3.
    22002200 *
    2201  * @param   pVM             The VM handle.
     2201 * @param   pVM             Pointer to the VM.
    22022202 * @param   GCPhys          Physical address start reading from.
    22032203 * @param   pvBuf           Where to put the read bits.
     
    23182318 * @retval  VERR_PGM_PHYS_WR_HIT_HANDLER in R0 and GC, NEVER in R3.
    23192319 *
    2320  * @param   pVM         The VM handle.
     2320 * @param   pVM         Pointer to the VM.
    23212321 * @param   pPage       The page descriptor.
    23222322 * @param   GCPhys      The physical address to start writing at.
     
    27332733 * @retval  VERR_PGM_PHYS_WR_HIT_HANDLER in R0 and GC, NEVER in R3.
    27342734 *
    2735  * @param   pVM             The VM handle.
     2735 * @param   pVM             Pointer to the VM.
    27362736 * @param   GCPhys          Physical address to write to.
    27372737 * @param   pvBuf           What to write.
     
    28462846 *
    28472847 * @returns VBox status.
    2848  * @param   pVM         The VM handle.
     2848 * @param   pVM         Pointer to the VM.
    28492849 * @param   pvDst       The destination address.
    28502850 * @param   GCPhysSrc   The source address (GC physical address).
     
    29182918 *
    29192919 * @returns VBox status.
    2920  * @param   pVM         The VM handle.
     2920 * @param   pVM         Pointer to the VM.
    29212921 * @param   GCPhysDst   The GC physical address of the destination.
    29222922 * @param   pvSrc       The source buffer.
     
    39893989 *
    39903990 * @returns The page type.
    3991  * @param   pVM             The VM handle.
     3991 * @param   pVM             Pointer to the VM.
    39923992 * @param   GCPhys          Guest physical address
    39933993 */
  • trunk/src/VBox/VMM/VMMAll/PGMAllPool.cpp

    r41744 r41783  
    140140 *
    141141 * @returns VBox status code suitable for scheduling.
    142  * @param   pVM         The VM handle.
     142 * @param   pVM         Pointer to the VM.
    143143 * @param   pvDst       Destination address
    144144 * @param   pvSrc       Source guest virtual address.
     
    738738 * @returns true if we consider the page as being reused for a different purpose.
    739739 * @returns false if we consider it to still be a paging page.
    740  * @param   pVM         The VM handle.
     740 * @param   pVM         Pointer to the VM.
    741741 * @param   pVCpu       VMCPU Handle.
    742742 * @param   pRegFrame   Trap register frame.
     
    820820 *
    821821 * @returns VBox status code suitable for scheduling.
    822  * @param   pVM         The VM handle.
     822 * @param   pVM         Pointer to the VM.
    823823 * @param   pVCpu       The VMCPU handle.
    824824 * @param   pPool       The pool.
     
    876876 *
    877877 * @returns VBox status code suitable for scheduling.
    878  * @param   pVM         The VM handle.
     878 * @param   pVM         Pointer to the VM.
    879879 * @param   pPool       The pool.
    880880 * @param   pPage       The pool page (head).
     
    947947 *
    948948 * @returns VBox status code suitable for scheduling.
    949  * @param   pVM         The VM handle.
     949 * @param   pVM         Pointer to the VM.
    950950 * @param   pVCpu       The VMCPU handle.
    951951 * @param   pPool       The pool.
     
    10341034 *
    10351035 * @returns VBox status code (appropriate for GC return).
    1036  * @param   pVM         The VM handle.
     1036 * @param   pVM         Pointer to the VM.
    10371037 * @param   uErrorCode  CPU Error code.
    10381038 * @param   pRegFrame   Trap register frame.
     
    16161616 * Flush a dirty page
    16171617 *
    1618  * @param   pVM             The VM handle.
     1618 * @param   pVM             Pointer to the VM.
    16191619 * @param   pPool           The pool.
    16201620 * @param   idxSlot         Dirty array slot index
     
    17151715 * Add a new dirty page
    17161716 *
    1717  * @param   pVM         The VM handle.
     1717 * @param   pVM         Pointer to the VM.
    17181718 * @param   pPool       The pool.
    17191719 * @param   pPage       The page.
     
    17921792 *
    17931793 * @return dirty or not
    1794  * @param   pVM             The VM handle.
     1794 * @param   pVM             Pointer to the VM.
    17951795 * @param   GCPhys          Guest physical address
    17961796 */
     
    18231823 * Reset all dirty pages by reinstating page monitoring.
    18241824 *
    1825  * @param   pVM             The VM handle.
     1825 * @param   pVM             Pointer to the VM.
    18261826 */
    18271827void pgmPoolResetDirtyPages(PVM pVM)
     
    18621862 * Invalidate the PT entry for the specified page
    18631863 *
    1864  * @param   pVM             The VM handle.
     1864 * @param   pVM             Pointer to the VM.
    18651865 * @param   GCPtrPage       Guest page to invalidate
    18661866 */
     
    18841884 * Reset all dirty pages by reinstating page monitoring.
    18851885 *
    1886  * @param   pVM             The VM handle.
     1886 * @param   pVM             Pointer to the VM.
    18871887 * @param   GCPhysPT        Physical address of the page table
    18881888 */
     
    26662666 * Zaps the list of modified pages, resetting their modification counters in the process.
    26672667 *
    2668  * @param   pVM     The VM handle.
     2668 * @param   pVM     Pointer to the VM.
    26692669 */
    26702670static void pgmPoolMonitorModifiedClearAll(PVM pVM)
     
    31013101 * @returns true / false indicating removal of all relevant PTEs
    31023102 *
    3103  * @param   pVM         The VM handle.
     3103 * @param   pVM         Pointer to the VM.
    31043104 * @param   pPhysPage   The guest page in question.
    31053105 * @param   fFlushPTEs  Flush PTEs or allow them to be updated (e.g. in case of an RW bit change)
     
    33533353 * Scans one shadow page table for mappings of a physical page.
    33543354 *
    3355  * @param   pVM         The VM handle.
     3355 * @param   pVM         Pointer to the VM.
    33563356 * @param   pPhysPage   The guest page in question.
    33573357 * @param   fFlushPTEs  Flush PTEs or allow them to be updated (e.g. in case of an RW bit change)
     
    33773377 * Flushes a list of shadow page tables mapping the same physical page.
    33783378 *
    3379  * @param   pVM         The VM handle.
     3379 * @param   pVM         Pointer to the VM.
    33803380 * @param   pPhysPage   The guest page in question.
    33813381 * @param   fFlushPTEs  Flush PTEs or allow them to be updated (e.g. in case of an RW bit change)
     
    34403440 *          pool cleaning. FF and sync flags are set.
    34413441 *
    3442  * @param   pVM         The VM handle.
     3442 * @param   pVM         Pointer to the VM.
    34433443 * @param   GCPhysPage  GC physical address of the page in question
    34443444 * @param   pPhysPage   The guest page in question.
     
    35533553 *          a page pool cleaning.
    35543554 *
    3555  * @param   pVM         The VM handle.
     3555 * @param   pVM         Pointer to the VM.
    35563556 * @param   pPhysPage   The guest page in question.
    35573557 */
     
    38613861 *
    38623862 * @returns Pointer to the allocated extent on success. NULL if we're out of them.
    3863  * @param   pVM         The VM handle.
     3863 * @param   pVM         Pointer to the VM.
    38643864 * @param   piPhysExt   Where to store the phys ext index.
    38653865 */
     
    38853885 * Frees a physical cross reference extent.
    38863886 *
    3887  * @param   pVM         The VM handle.
     3887 * @param   pVM         Pointer to the VM.
    38883888 * @param   iPhysExt    The extent to free.
    38893889 */
     
    39073907 * Frees a physical cross reference extent.
    39083908 *
    3909  * @param   pVM         The VM handle.
     3909 * @param   pVM         Pointer to the VM.
    39103910 * @param   iPhysExt    The extent to free.
    39113911 */
     
    39413941 * @returns The new tracking data for PGMPAGE.
    39423942 *
    3943  * @param   pVM         The VM handle.
     3943 * @param   pVM         Pointer to the VM.
    39443944 * @param   iPhysExt    The physical extent index of the list head.
    39453945 * @param   iShwPT      The shadow page table index.
     
    40294029 * @returns The new tracking data for PGMPAGE.
    40304030 *
    4031  * @param   pVM         The VM handle.
     4031 * @param   pVM         Pointer to the VM.
    40324032 * @param   pPhysPage   Pointer to the aPages entry in the ram range.
    40334033 * @param   u16         The ram range flags (top 16-bits).
     
    49684968 * @retval  VERR_PGM_POOL_FLUSHED if the pool was flushed.
    49694969 *
    4970  * @param   pVM         The VM handle.
     4970 * @param   pVM         Pointer to the VM.
    49714971 * @param   GCPhys      The GC physical address of the page we're gonna shadow.
    49724972 *                      For 4MB and 2MB PD entries, it's the first address the
     
    51065106 * Frees a usage of a pool page.
    51075107 *
    5108  * @param   pVM         The VM handle.
     5108 * @param   pVM         Pointer to the VM.
    51095109 * @param   HCPhys      The HC physical address of the shadow page.
    51105110 * @param   iUser       The shadow page pool index of the user table.
     
    51585158 * Flush the specified page if present
    51595159 *
    5160  * @param   pVM     The VM handle.
     5160 * @param   pVM     Pointer to the VM.
    51615161 * @param   GCPhys  Guest physical address of the page to flush
    51625162 */
     
    52435243 * Reset CPU on hot plugging.
    52445244 *
    5245  * @param   pVM                 The VM handle.
     5245 * @param   pVM                 Pointer to the VM.
    52465246 * @param   pVCpu               The virtual CPU.
    52475247 */
  • trunk/src/VBox/VMM/VMMAll/REMAll.cpp

    r41777 r41783  
    4040 * Records a invlpg instruction for replaying upon REM entry.
    4141 *
    42  * @param   pVM         The VM handle.
     42 * @param   pVM         Pointer to the VM.
    4343 * @param   GCPtrPage   The
    4444 */
     
    205205 * This is for avoiding trouble in RC when changing CR3.
    206206 *
    207  * @param   pVM         The VM handle.
     207 * @param   pVM         Pointer to the VM.
    208208 * @param   pVCpu       The virtual CPU handle of the calling EMT.
    209209 */
  • trunk/src/VBox/VMM/VMMAll/SELMAll.cpp

    r41727 r41783  
    10921092 * Gets the hypervisor code selector (CS).
    10931093 * @returns CS selector.
    1094  * @param   pVM     The VM handle.
     1094 * @param   pVM     Pointer to the VM.
    10951095 */
    10961096VMMDECL(RTSEL) SELMGetHyperCS(PVM pVM)
     
    11031103 * Gets the 64-mode hypervisor code selector (CS64).
    11041104 * @returns CS selector.
    1105  * @param   pVM     The VM handle.
     1105 * @param   pVM     Pointer to the VM.
    11061106 */
    11071107VMMDECL(RTSEL) SELMGetHyperCS64(PVM pVM)
     
    11141114 * Gets the hypervisor data selector (DS).
    11151115 * @returns DS selector.
    1116  * @param   pVM     The VM handle.
     1116 * @param   pVM     Pointer to the VM.
    11171117 */
    11181118VMMDECL(RTSEL) SELMGetHyperDS(PVM pVM)
     
    11251125 * Gets the hypervisor TSS selector.
    11261126 * @returns TSS selector.
    1127  * @param   pVM     The VM handle.
     1127 * @param   pVM     Pointer to the VM.
    11281128 */
    11291129VMMDECL(RTSEL) SELMGetHyperTSS(PVM pVM)
     
    11361136 * Gets the hypervisor TSS Trap 8 selector.
    11371137 * @returns TSS Trap 8 selector.
    1138  * @param   pVM     The VM handle.
     1138 * @param   pVM     Pointer to the VM.
    11391139 */
    11401140VMMDECL(RTSEL) SELMGetHyperTSSTrap08(PVM pVM)
     
    11471147 *
    11481148 * @returns The GDT address.
    1149  * @param   pVM     The VM handle.
     1149 * @param   pVM     Pointer to the VM.
    11501150 * @remark  This is intended only for very special use, like in the world
    11511151 *          switchers. Don't exploit this API!
     
    11701170 * @retval  VERR_SELM_NO_TSS if we haven't got a TSS (rather unlikely).
    11711171 *
    1172  * @param   pVM                 The VM handle.
     1172 * @param   pVM                 Pointer to the VM.
    11731173 * @param   pVCpu               VMCPU Handle.
    11741174 * @param   pGCPtrTss           Where to store the TSS address.
  • trunk/src/VBox/VMM/VMMAll/TMAll.cpp

    r41777 r41783  
    7878 *
    7979 * @returns The warp drive percent.
    80  * @param   pVM         The VM handle.
     80 * @param   pVM         Pointer to the VM.
    8181 */
    8282VMMDECL(uint32_t) TMGetWarpDrive(PVM pVM)
     
    226226 * Raise the timer force action flag and notify the dedicated timer EMT.
    227227 *
    228  * @param   pVM         The VM handle.
     228 * @param   pVM         Pointer to the VM.
    229229 */
    230230DECLINLINE(void) tmScheduleNotify(PVM pVM)
     
    10901090 * @returns VBox status code.
    10911091 *
    1092  * @param   pVM             The VM handle.
     1092 * @param   pVM             Pointer to the VM.
    10931093 * @param   pTimer          The timer handle.
    10941094 * @param   u64Expire       The new expire time.
     
    11331133 *
    11341134 * @returns VBox status code
    1135  * @param   pVM                 The VM handle.
     1135 * @param   pVM                 Pointer to the VM.
    11361136 * @param   pTimer              The timer handle.
    11371137 * @param   u64Expire           The expiration time.
     
    13591359 *
    13601360 * @returns Current time.
    1361  * @param   pVM             The VM handle.
     1361 * @param   pVM             Pointer to the VM.
    13621362 * @param   enmClock        The clock to query.
    13631363 * @param   pu64Now         Optional pointer where to store the return time
     
    13921392 * @returns VBox status code.
    13931393 *
    1394  * @param   pVM             The VM handle.
     1394 * @param   pVM             Pointer to the VM.
    13951395 * @param   pTimer          The timer handle.
    13961396 * @param   cTicksToNext    Clock ticks until the next time expiration.
     
    14311431 *
    14321432 * @returns VBox status code
    1433  * @param   pVM                 The VM handle.
     1433 * @param   pVM                 Pointer to the VM.
    14341434 * @param   cTicksToNext        Clock ticks until the next time expiration.
    14351435 * @param   pu64Now             Where to return the current time stamp used.
     
    17601760 *
    17611761 * @returns VBox status code
    1762  * @param   pVM                 The VM handle.
     1762 * @param   pVM                 Pointer to the VM.
    17631763 * @param   pTimer              The timer handle.
    17641764 */
     
    24332433 *
    24342434 * @returns The highest frequency.  0 if no timers care.
    2435  * @param   pVM         The VM handle.
     2435 * @param   pVM         Pointer to the VM.
    24362436 */
    24372437static uint32_t tmGetFrequencyHint(PVM pVM)
     
    25032503 *
    25042504 * @returns The highest frequency.  0 if no important timers around.
    2505  * @param   pVM         The VM handle.
     2505 * @param   pVM         Pointer to the VM.
    25062506 * @param   pVCpu       The current CPU.
    25072507 */
  • trunk/src/VBox/VMM/VMMAll/TMAllCpu.cpp

    r39402 r41783  
    104104 * Used by TMCpuTickCanUseRealTSC and TMCpuTickGetDeadlineAndTscOffset.
    105105 *
    106  * @param   pVM         The VM handle.
     106 * @param   pVM         Pointer to the VM.
    107107 * @param   pVCpu       The current CPU.
    108108 */
     
    363363 *
    364364 * @returns VBox status code.
    365  * @param   pVM         The VM handle.
     365 * @param   pVM         Pointer to the VM.
    366366 * @param   pVCpu       The virtual CPU to operate on.
    367367 * @param   u64Tick     The new timestamp value.
  • trunk/src/VBox/VMM/VMMAll/TMAllReal.cpp

    r39078 r41783  
    3131 *
    3232 * @returns Real time.
    33  * @param   pVM             The VM handle.
     33 * @param   pVM             Pointer to the VM.
    3434 */
    3535VMM_INT_DECL(uint64_t) TMRealGet(PVM pVM)
     
    4444 *
    4545 * @returns frequency.
    46  * @param   pVM             The VM handle.
     46 * @param   pVM             Pointer to the VM.
    4747 */
    4848VMM_INT_DECL(uint64_t) TMRealGetFreq(PVM pVM)
  • trunk/src/VBox/VMM/VMMAll/TMAllVirtual.cpp

    r40274 r41783  
    108108 *
    109109 * @returns Nanosecond timestamp.
    110  * @param   pVM     The VM handle.
     110 * @param   pVM     Pointer to the VM.
    111111 */
    112112static uint64_t tmVirtualGetRawNanoTS(PVM pVM)
     
    283283 *
    284284 * @returns The timestamp.
    285  * @param   pVM     The VM handle.
     285 * @param   pVM     Pointer to the VM.
    286286 */
    287287static uint64_t tmVirtualGetRawNonNormal(PVM pVM)
     
    311311 *
    312312 * @returns The current time stamp.
    313  * @param   pVM     The VM handle.
     313 * @param   pVM     Pointer to the VM.
    314314 */
    315315DECLINLINE(uint64_t) tmVirtualGetRaw(PVM pVM)
     
    404404 *
    405405 * @returns Host nano second count.
    406  * @param   pVM                     The VM handle.
     406 * @param   pVM                     Pointer to the VM.
    407407 * @param   cVirtTicksToDeadline    The TMCLOCK_VIRTUAL interval.
    408408 */
     
    533533 *
    534534 * @returns timesamp.
    535  * @param   pVM                 The VM handle.
     535 * @param   pVM                 Pointer to the VM.
    536536 * @param   u64                 The virtual clock timestamp.
    537537 * @param   pcNsToDeadline      Where to return the number of nano seconds to
     
    977977 *
    978978 * @returns VINF_SUCCESS or VERR_TM_VIRTUAL_TICKING_IPE (asserted).
    979  * @param   pVM     The VM handle.
     979 * @param   pVM     Pointer to the VM.
    980980 */
    981981int tmVirtualPauseLocked(PVM pVM)
     
    997997 *
    998998 * @returns VINF_SUCCESS or VERR_TM_VIRTUAL_TICKING_IPE (asserted).
    999  * @param   pVM     The VM handle.
     999 * @param   pVM     Pointer to the VM.
    10001000 */
    10011001int tmVirtualResumeLocked(PVM pVM)
     
    10191019 *
    10201020 * @returns nanoseconds.
    1021  * @param   pVM             The VM handle.
     1021 * @param   pVM             Pointer to the VM.
    10221022 * @param   u64VirtualTicks The virtual ticks to convert.
    10231023 * @remark  There could be rounding errors here. We just do a simple integer divide
     
    10361036 *
    10371037 * @returns microseconds.
    1038  * @param   pVM             The VM handle.
     1038 * @param   pVM             Pointer to the VM.
    10391039 * @param   u64VirtualTicks The virtual ticks to convert.
    10401040 * @remark  There could be rounding errors here. We just do a simple integer divide
     
    10531053 *
    10541054 * @returns milliseconds.
    1055  * @param   pVM             The VM handle.
     1055 * @param   pVM             Pointer to the VM.
    10561056 * @param   u64VirtualTicks The virtual ticks to convert.
    10571057 * @remark  There could be rounding errors here. We just do a simple integer divide
     
    10701070 *
    10711071 * @returns virtual ticks.
    1072  * @param   pVM             The VM handle.
     1072 * @param   pVM             Pointer to the VM.
    10731073 * @param   u64NanoTS       The nanosecond value ticks to convert.
    10741074 * @remark  There could be rounding and overflow errors here.
     
    10861086 *
    10871087 * @returns virtual ticks.
    1088  * @param   pVM             The VM handle.
     1088 * @param   pVM             Pointer to the VM.
    10891089 * @param   u64MicroTS      The microsecond value ticks to convert.
    10901090 * @remark  There could be rounding and overflow errors here.
     
    11021102 *
    11031103 * @returns virtual ticks.
    1104  * @param   pVM             The VM handle.
     1104 * @param   pVM             Pointer to the VM.
    11051105 * @param   u64MilliTS      The millisecond value ticks to convert.
    11061106 * @remark  There could be rounding and overflow errors here.
  • trunk/src/VBox/VMM/VMMAll/TRPMAll.cpp

    r41732 r41783  
    754754 * @retval  VINF_EM_RESCHEDULE_REM if the exception was dispatched and cannot be executed in raw-mode.
    755755 *
    756  * @param   pVM         The VM handle.
     756 * @param   pVM         Pointer to the VM.
    757757 * @param   pCtxCore    The CPU context core.
    758758 * @param   enmXcpt     The exception.
     
    780780 * @retval  VINF_EM_RESCHEDULE_REM if the exception was dispatched and cannot be executed in raw-mode.
    781781 *
    782  * @param   pVM         The VM handle.
     782 * @param   pVM         Pointer to the VM.
    783783 * @param   pCtxCore    The CPU context core.
    784784 * @param   enmXcpt     The exception.
     
    807807 * @retval  VINF_EM_RESCHEDULE_REM if the exception was dispatched and cannot be executed in raw-mode.
    808808 *
    809  * @param   pVM         The VM handle.
     809 * @param   pVM         Pointer to the VM.
    810810 * @param   pCtxCore    The CPU context core.
    811811 * @param   enmXcpt     The exception.
  • trunk/src/VBox/VMM/VMMAll/VMAll.cpp

    r39078 r41783  
    185185 *          propagated up the stack.
    186186 *
    187  * @param   pVM             The VM handle.
     187 * @param   pVM             Pointer to the VM.
    188188 *
    189189 * @param   fFlags          Flags indicating which actions to take.
     
    221221 *          propagated up the stack.
    222222 *
    223  * @param   pVM             The VM handle.
     223 * @param   pVM             Pointer to the VM.
    224224 * @param   fFlags          Flags indicating which actions to take. See
    225225 *                          VMSETRTERR_FLAGS_*.
  • trunk/src/VBox/VMM/VMMAll/VMMAll.cpp

    r41417 r41783  
    185185 * @returns The CPU ID. NIL_VMCPUID if the thread isn't an EMT.
    186186 *
    187  * @param   pVM         The VM handle.
     187 * @param   pVM         Pointer to the VM.
    188188 */
    189189VMMDECL(VMCPUID) VMMGetCpuId(PVM pVM)
     
    236236 * @returns The VMCPU pointer. NULL if not an EMT.
    237237 *
    238  * @param   pVM         The VM handle.
     238 * @param   pVM         Pointer to the VM.
    239239 */
    240240VMMDECL(PVMCPU) VMMGetCpu(PVM pVM)
     
    290290 *
    291291 * @returns The VMCPU pointer.
    292  * @param   pVM         The VM handle.
     292 * @param   pVM         Pointer to the VM.
    293293 */
    294294VMMDECL(PVMCPU) VMMGetCpu0(PVM pVM)
     
    304304 * @returns The VMCPU pointer. NULL if idCpu is invalid.
    305305 *
    306  * @param   pVM         The VM handle.
     306 * @param   pVM         Pointer to the VM.
    307307 * @param   idCpu       The ID of the virtual CPU.
    308308 */
     
    332332 *
    333333 * @returns active switcher
    334  * @param   pVM             The VM handle.
     334 * @param   pVM             Pointer to the VM.
    335335 */
    336336VMMDECL(VMMSWITCHER) VMMGetSwitcher(PVM pVM)
Note: See TracChangeset for help on using the changeset viewer.

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette