VirtualBox

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


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/VMMR3
Files:
59 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/VBox/VMM/VMMR3/CFGM.cpp

    r41009 r41783  
    11811181 *
    11821182 * @returns Pointer to the root node.
    1183  * @param   pVM         The VM handle.
     1183 * @param   pVM         Pointer to the VM.
    11841184 */
    11851185VMMR3DECL(PCFGMNODE) CFGMR3CreateTree(PVM pVM)
    … …  
    29852985 * Info handler, internal version.
    29862986 *
    2987  * @param   pVM         The VM handle.
     2987 * @param   pVM         Pointer to the VM.
    29882988 * @param   pHlp        Callback functions for doing output.
    29892989 * @param   pszArgs     Argument string. Optional and specific to the handler.

  • trunk/src/VBox/VMM/VMMR3/CPUM.cpp

    r41774 r41783  
    11491149 *
    11501150 * @returns VINF_SUCCESS.
    1151  * @param   pVM         The VM handle.
     1151 * @param   pVM         Pointer to the VM.
    11521152 */
    11531153VMMR3DECL(void) CPUMR3Reset(PVM pVM)
    … …  
    11721172 * Called both in pass 0 and the final pass.
    11731173 *
    1174  * @param   pVM                 The VM handle.
     1174 * @param   pVM                 Pointer to the VM.
    11751175 * @param   pSSM                The saved state handle.
    11761176 */
    … …  
    12141214 *
    12151215 * @returns VBox status code.
    1216  * @param   pVM                 The VM handle.
     1216 * @param   pVM                 Pointer to the VM.
    12171217 * @param   pSSM                The saved state handle.
    12181218 * @param   uVersion            The format version.
    … …  
    19211921 *
    19221922 * @returns VINF_SSM_DONT_CALL_AGAIN.
    1923  * @param   pVM                 The VM handle.
     1923 * @param   pVM                 Pointer to the VM.
    19241924 * @param   pSSM                The saved state handle.
    19251925 * @param   uPass               The pass (0).
    … …  
    23282328 *
    23292329 * @returns true / false.
    2330  * @param   pVM                 The VM handle.
     2330 * @param   pVM                 Pointer to the VM.
    23312331 */
    23322332VMMDECL(bool) CPUMR3IsStateRestorePending(PVM pVM)
    … …  
    35013501    /** Pointer to the CPU structure. */
    35023502    PDISCPUSTATE    pCpu;
    3503     /** The VM handle. */
     3503    /** Pointer to the VM. */
    35043504    PVM             pVM;
    35053505    /** The VMCPU handle. */
    … …  
    37353735 * @returns VBox status code.
    37363736 *
    3737  * @param   pVM     The VM handle.
     3737 * @param   pVM     Pointer to the VM.
    37383738 * @param   fOr     The CR4 OR mask.
    37393739 * @param   fAnd    The CR4 AND mask.
    … …  
    37573757 *
    37583758 * @returns Pointer to the standard CPUID leaves (read-only).
    3759  * @param   pVM         The VM handle.
     3759 * @param   pVM         Pointer to the VM.
    37603760 * @remark  Intended for PATM.
    37613761 */
    … …  
    37723772 *
    37733773 * @returns Pointer to the extended CPUID leaves (read-only).
    3774  * @param   pVM         The VM handle.
     3774 * @param   pVM         Pointer to the VM.
    37753775 * @remark  Intended for PATM.
    37763776 */
    … …  
    37873787 *
    37883788 * @returns Pointer to the centaur CPUID leaves (read-only).
    3789  * @param   pVM         The VM handle.
     3789 * @param   pVM         Pointer to the VM.
    37903790 * @remark  Intended for PATM.
    37913791 */
    … …  
    38003800 *
    38013801 * @returns Pointer to the default CPUID leaf (read-only).
    3802  * @param   pVM         The VM handle.
     3802 * @param   pVM         Pointer to the VM.
    38033803 * @remark  Intended for PATM.
    38043804 */

  • trunk/src/VBox/VMM/VMMR3/CPUMDbg.cpp

    r40076 r41783  
    12871287 *
    12881288 * @returns VBox status code.
    1289  * @param   pVM                 The VM handle.
     1289 * @param   pVM                 Pointer to the VM.
    12901290 */
    12911291int cpumR3DbgInit(PVM pVM)

  • trunk/src/VBox/VMM/VMMR3/DBGF.cpp

    r41777 r41783  
    334334 * and have to block certain operations.
    335335 *
    336  * @param   pVM         The VM handle.
     336 * @param   pVM         Pointer to the VM.
    337337 * @param   enmEvent    The event.
    338338 */
    … …  
    357357 *
    358358 * @returns debug event context.
    359  * @param   pVM         The VM handle.
     359 * @param   pVM         Pointer to the VM.
    360360 */
    361361static DBGFEVENTCTX dbgfR3FigureEventCtx(PVM pVM)
    … …  
    389389 *
    390390 * @returns VBox status.
    391  * @param   pVM         The VM handle.
     391 * @param   pVM         Pointer to the VM.
    392392 * @param   enmEvent    The event to be sent.
    393393 */
    … …  
    429429 *
    430430 * @returns VBox status code.
    431  * @param   pVM     The VM handle.
     431 * @param   pVM     Pointer to the VM.
    432432 */
    433433static int dbgfR3SendEvent(PVM pVM)
    … …  
    447447 *
    448448 * @returns VBox status.
    449  * @param   pVM         The VM handle.
     449 * @param   pVM         Pointer to the VM.
    450450 * @param   enmEvent    The event to send.
    451451 */
    … …  
    469469 *
    470470 * @returns VBox status.
    471  * @param   pVM         The VM handle.
     471 * @param   pVM         Pointer to the VM.
    472472 * @param   enmEvent    The event to send.
    473473 * @param   pszFile     Source file.
    … …  
    491491 *
    492492 * @returns VBox status.
    493  * @param   pVM         The VM handle.
     493 * @param   pVM         Pointer to the VM.
    494494 * @param   enmEvent    The event to send.
    495495 * @param   pszFile     Source file.
    … …  
    533533 *
    534534 * @returns VBox status.
    535  * @param   pVM         The VM handle.
     535 * @param   pVM         Pointer to the VM.
    536536 * @param   enmEvent    The event to send.
    537537 * @param   pszMsg1     First assertion message.
    … …  
    560560 *
    561561 * @returns VBox status.
    562  * @param   pVM         The VM handle.
     562 * @param   pVM         Pointer to the VM.
    563563 * @param   enmEvent    DBGFEVENT_BREAKPOINT_HYPER or DBGFEVENT_BREAKPOINT.
    564564 */

  • trunk/src/VBox/VMM/VMMR3/DBGFAddr.cpp

    r39078 r41783  
    3838 * @returns true if it's inside the HMA.
    3939 * @returns flase if it's not inside the HMA.
    40  * @param   pVM         The VM handle.
     40 * @param   pVM         Pointer to the VM.
    4141 * @param   FlatPtr     The address in question.
    4242 */
    … …  
    9292 *
    9393 * @returns VBox status code.
    94  * @param   pVM         The VM handle.
     94 * @param   pVM         Pointer to the VM.
    9595 * @param   idCpu       The CPU ID.
    9696 * @param   pAddress    Where to store the mixed address.
    … …  
    132132 *
    133133 * @returns VBox status code.
    134  * @param   pVM         The VM handle.
     134 * @param   pVM         Pointer to the VM.
    135135 * @param   idCpu       The CPU ID.
    136136 * @param   pAddress    Where to store the mixed address.
    … …  
    156156 *
    157157 * @returns pAddress.
    158  * @param   pVM         The VM handle.
     158 * @param   pVM         Pointer to the VM.
    159159 * @param   pAddress    Where to store the mixed address.
    160160 * @param   FlatPtr     The flat pointer.
    … …  
    176176 *
    177177 * @returns pAddress.
    178  * @param   pVM         The VM handle.
     178 * @param   pVM         Pointer to the VM.
    179179 * @param   pAddress    Where to store the mixed address.
    180180 * @param   PhysAddr    The guest physical address.
    … …  
    196196 * @returns true if valid.
    197197 * @returns false if invalid.
    198  * @param   pVM         The VM handle.
     198 * @param   pVM         Pointer to the VM.
    199199 * @param   pAddress    The address to validate.
    200200 */
    … …  
    241241 * @retval  VERR_PAGE_MAP_LEVEL4_NOT_PRESENT
    242242 *
    243  * @param   pVM             The VM handle.
     243 * @param   pVM             Pointer to the VM.
    244244 * @param   idCpu           The ID of the CPU context to convert virtual
    245245 *                          addresses.
    … …  
    299299 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS
    300300 *
    301  * @param   pVM             The VM handle.
     301 * @param   pVM             Pointer to the VM.
    302302 * @param   idCpu           The ID of the CPU context to convert virtual
    303303 *                          addresses.
    … …  
    339339 * @returns VBox status code.
    340340 *
    341  * @param   pVM             The VM handle.
     341 * @param   pVM             Pointer to the VM.
    342342 * @param   idCpu           The ID of the CPU context.
    343343 * @param   pAddress        The address.
    … …  
    410410 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS
    411411 *
    412  * @param   pVM             The VM handle.
     412 * @param   pVM             Pointer to the VM.
    413413 * @param   idCpu           The ID of the CPU context to convert virtual
    414414 *                          addresses.

  • trunk/src/VBox/VMM/VMMR3/DBGFAddrSpace.cpp

    r41497 r41783  
    134134 *
    135135 * @returns VBox status code.
    136  * @param   pVM             The VM handle.
     136 * @param   pVM             Pointer to the VM.
    137137 */
    138138int dbgfR3AsInit(PVM pVM)
    … …  
    207207 * Terminates the address space parts of DBGF.
    208208 *
    209  * @param   pVM             The VM handle.
     209 * @param   pVM             Pointer to the VM.
    210210 */
    211211void dbgfR3AsTerm(PVM pVM)
    … …  
    233233 * Relocates the RC address space.
    234234 *
    235  * @param   pVM             The VM handle.
     235 * @param   pVM             Pointer to the VM.
    236236 * @param   offDelta        The relocation delta.
    237237 */
    … …  
    247247 *
    248248 * @returns VBox status code.
    249  * @param   pVM             The VM handle.
     249 * @param   pVM             Pointer to the VM.
    250250 * @param   hDbgAs          The address space handle. The reference of the
    251251 *                          caller will NOT be consumed.
    … …  
    305305 * @retval  VERR_NOT_FOUND if not found in the address space database.
    306306 *
    307  * @param   pVM             The VM handle.
     307 * @param   pVM             Pointer to the VM.
    308308 * @param   hDbgAs          The address space handle. Aliases are not allowed.
    309309 */
    … …  
    366366 *
    367367 * @returns VBox status code.
    368  * @param   pVM             The VM handle.
     368 * @param   pVM             Pointer to the VM.
    369369 * @param   hAlias          The alias to change.
    370370 * @param   hAliasFor       The address space hAlias should be an alias for.
    … …  
    437437 * Lazily populates the specified address space.
    438438 *
    439  * @param   pVM                 The VM handle.
     439 * @param   pVM                 Pointer to the VM.
    440440 * @param   hAlias              The alias.
    441441 */
    … …  
    462462 * @returns Real address space handle. NIL_RTDBGAS if invalid handle.
    463463 *
    464  * @param   pVM             The VM handle.
     464 * @param   pVM             Pointer to the VM.
    465465 * @param   hAlias          The possibly address space alias.
    466466 *
    … …  
    485485 * @returns Real address space handle. NIL_RTDBGAS if invalid handle.
    486486 *
    487  * @param   pVM             The VM handle.
     487 * @param   pVM             Pointer to the VM.
    488488 * @param   hAlias          The possibly address space alias.
    489489 */
    … …  
    529529 * @returns Retained address space handle if found, NIL_RTDBGAS if not.
    530530 *
    531  * @param   pVM         The VM handle.
     531 * @param   pVM         Pointer to the VM.
    532532 * @param   pszName     The name.
    533533 */
    … …  
    567567 * @returns Retained address space handle if found, NIL_RTDBGAS if not.
    568568 *
    569  * @param   pVM         The VM handle.
     569 * @param   pVM         Pointer to the VM.
    570570 * @param   ProcId      The process ID.
    571571 */
    … …  
    758758 * @returns VBox status code.
    759759 *
    760  * @param   pVM             The VM handle.
     760 * @param   pVM             Pointer to the VM.
    761761 * @param   hDbgAs          The address space.
    762762 * @param   pszFilename     The filename of the executable module.
    … …  
    830830 * @returns VBox status code.
    831831 *
    832  * @param   pVM             The VM handle.
     832 * @param   pVM             Pointer to the VM.
    833833 * @param   hDbgAs          The address space.
    834834 * @param   pszFilename     The map file.
    … …  
    888888 *
    889889 * @returns VBox status code.
    890  * @param   pVM             The VM handle.
     890 * @param   pVM             Pointer to the VM.
    891891 * @param   hDbgAs          The address space handle.
    892892 * @param   hMod            The module handle.
    … …  
    967967 * @returns VBox status code. See RTDbgAsSymbolByAddr.
    968968 *
    969  * @param   pVM                 The VM handle.
     969 * @param   pVM                 Pointer to the VM.
    970970 * @param   hDbgAs              The address space handle.
    971971 * @param   pAddress            The address to lookup.
    … …  
    10661066 *          occurs.
    10671067 *
    1068  * @param   pVM                 The VM handle.
     1068 * @param   pVM                 Pointer to the VM.
    10691069 * @param   hDbgAs              See DBGFR3AsSymbolByAddr.
    10701070 * @param   pAddress            See DBGFR3AsSymbolByAddr.
    … …  
    10911091 * @returns VBox status code. See RTDbgAsSymbolByAddr.
    10921092 *
    1093  * @param   pVM                 The VM handle.
     1093 * @param   pVM                 Pointer to the VM.
    10941094 * @param   hDbgAs              The address space handle.
    10951095 * @param   pszSymbol           The symbol to search for, maybe prefixed by a

  • trunk/src/VBox/VMM/VMMR3/DBGFBp.cpp

    r40274 r41783  
    6161 *
    6262 * @returns VINF_SUCCESS
    63  * @param   pVM     The VM handle.
     63 * @param   pVM     Pointer to the VM.
    6464 */
    6565int dbgfR3BpInit(PVM pVM)
    … …  
    9797 * @returns Pointer to the allocated breakpoint.
    9898 * @returns NULL if we're out of breakpoints.
    99  * @param   pVM     The VM handle.
     99 * @param   pVM     Pointer to the VM.
    100100 * @param   enmType The type to allocate.
    101101 */
    … …  
    150150 * @returns Pointer to the allocated breakpoint.
    151151 * @returns NULL if the breakpoint is invalid.
    152  * @param   pVM     The VM handle.
     152 * @param   pVM     Pointer to the VM.
    153153 * @param   iBp     The breakpoint id.
    154154 */
    … …  
    192192 * @returns Pointer to the allocated breakpoint.
    193193 * @returns NULL if the breakpoint is invalid.
    194  * @param   pVM     The VM handle.
     194 * @param   pVM     Pointer to the VM.
    195195 * @param   enmType The breakpoint type.
    196196 * @param   GCPtr   The breakpoint address.
    … …  
    238238 * Frees a breakpoint.
    239239 *
    240  * @param   pVM     The VM handle.
     240 * @param   pVM     Pointer to the VM.
    241241 * @param   pBp     The breakpoint to free.
    242242 */
    … …  
    273273 *
    274274 * @returns VBox status code.
    275  * @param   pVM         The VM handle.
     275 * @param   pVM         Pointer to the VM.
    276276 * @param   pAddress    The address of the breakpoint.
    277277 * @param   iHitTrigger The hit count at which the breakpoint start triggering.
    … …  
    298298 *
    299299 * @returns VBox status code.
    300  * @param   pVM             The VM handle.
     300 * @param   pVM             Pointer to the VM.
    301301 * @param   pAddress        The address of the breakpoint.
    302302 * @param   piHitTrigger    The hit count at which the breakpoint start triggering.
    … …  
    370370 *
    371371 * @returns VBox status code.
    372  * @param   pVM         The VM handle.
     372 * @param   pVM         Pointer to the VM.
    373373 * @param   pBp         The breakpoint.
    374374 */
    … …  
    400400 *
    401401 * @returns VBox status code.
    402  * @param   pVM         The VM handle.
     402 * @param   pVM         Pointer to the VM.
    403403 * @param   pBp         The breakpoint.
    404404 */
    … …  
    426426 *
    427427 * @returns VBox status code.
    428  * @param   pVM         The VM handle.
     428 * @param   pVM         Pointer to the VM.
    429429 * @param   pAddress    The address of the breakpoint.
    430430 * @param   iHitTrigger The hit count at which the breakpoint start triggering.
    … …  
    456456 *
    457457 * @returns VBox status code.
    458  * @param   pVM             The VM handle.
     458 * @param   pVM             Pointer to the VM.
    459459 * @param   pAddress        The address of the breakpoint.
    460460 * @param   piHitTrigger    The hit count at which the breakpoint start triggering.
    … …  
    563563 *
    564564 * @returns VBox status code.
    565  * @param   pVM         The VM handle.
     565 * @param   pVM         Pointer to the VM.
    566566 * @param   pBp         The breakpoint.
    567567 */
    … …  
    581581 *
    582582 * @returns VBox status code.
    583  * @param   pVM         The VM handle.
     583 * @param   pVM         Pointer to the VM.
    584584 * @param   pBp         The breakpoint.
    585585 */
    … …  
    598598 *
    599599 * @returns VBox status code.
    600  * @param   pVM         The VM handle.
     600 * @param   pVM         Pointer to the VM.
    601601 * @param   pAddress    The address of the breakpoint.
    602602 * @param   iHitTrigger The hit count at which the breakpoint start triggering.
    … …  
    622622 *
    623623 * @returns VBox status code.
    624  * @param   pVM             The VM handle.
     624 * @param   pVM             Pointer to the VM.
    625625 * @param   pAddress        The address of the breakpoint.
    626626 * @param   piHitTrigger    The hit count at which the breakpoint start triggering.
    … …  
    703703 *
    704704 * @returns VBox status code.
    705  * @param   pVM         The VM handle.
     705 * @param   pVM         Pointer to the VM.
    706706 * @param   iBp         The id of the breakpoint which should be removed (cleared).
    707707 * @thread  Any thread.
    … …  
    722722 *
    723723 * @returns VBox status code.
    724  * @param   pVM         The VM handle.
     724 * @param   pVM         Pointer to the VM.
    725725 * @param   iBp         The id of the breakpoint which should be removed (cleared).
    726726 * @thread  EMT
    … …  
    779779 *
    780780 * @returns VBox status code.
    781  * @param   pVM         The VM handle.
     781 * @param   pVM         Pointer to the VM.
    782782 * @param   iBp         The id of the breakpoint which should be enabled.
    783783 * @thread  Any thread.
    … …  
    798798 *
    799799 * @returns VBox status code.
    800  * @param   pVM         The VM handle.
     800 * @param   pVM         Pointer to the VM.
    801801 * @param   iBp         The id of the breakpoint which should be enabled.
    802802 * @thread  EMT
    … …  
    855855 *
    856856 * @returns VBox status code.
    857  * @param   pVM         The VM handle.
     857 * @param   pVM         Pointer to the VM.
    858858 * @param   iBp         The id of the breakpoint which should be disabled.
    859859 * @thread  Any thread.
    … …  
    874874 *
    875875 * @returns VBox status code.
    876  * @param   pVM         The VM handle.
     876 * @param   pVM         Pointer to the VM.
    877877 * @param   iBp         The id of the breakpoint which should be disabled.
    878878 * @thread  EMT
    … …  
    929929 *
    930930 * @returns VBox status code.
    931  * @param   pVM         The VM handle.
     931 * @param   pVM         Pointer to the VM.
    932932 * @param   pfnCallback The callback function.
    933933 * @param   pvUser      The user argument to pass to the callback.
    … …  
    949949 *
    950950 * @returns VBox status code.
    951  * @param   pVM         The VM handle.
     951 * @param   pVM         Pointer to the VM.
    952952 * @param   pfnCallback The callback function.
    953953 * @param   pvUser      The user argument to pass to the callback.

  • trunk/src/VBox/VMM/VMMR3/DBGFCoreWrite.cpp

    r41774 r41783  
    297297 * memory area suitable for dumping to a core file.
    298298 *
    299  * @param pVM               The VM handle.
     299 * @param pVM               Pointer to the VM.
    300300 *
    301301 * @return Number of memory ranges
    … …  
    311311 *
    312312 * @returns VBox status code
    313  * @param   pVM                 The VM handle.
     313 * @param   pVM                 Pointer to the VM.
    314314 * @param   hFile               The file to write to.  Caller closes this.
    315315 */
    … …  
    493493 * EMT Rendezvous worker function for DBGFR3CoreWrite.
    494494 *
    495  * @param   pVM              The VM handle.
     495 * @param   pVM              Pointer to the VM.
    496496 * @param   pVCpu            The handle of the calling VCPU.
    497497 * @param   pvData           Opaque data.
    … …  
    534534 *
    535535 * @returns VBox status code.
    536  * @param   pVM                 The VM handle.
     536 * @param   pVM                 Pointer to the VM.
    537537 * @param   pszFilename         The name of the file to which the guest core
    538538 *                              dump should be written.

  • trunk/src/VBox/VMM/VMMR3/DBGFCpu.cpp

    r38838 r41783  
    3535 *
    3636 * @returns VINF_SUCCESS.
    37  * @param   pVM                 The VM handle.
     37 * @param   pVM                 Pointer to the VM.
    3838 * @param   idCpu               The current CPU ID.
    3939 * @param   penmMode            Where to return the mode.
    … …  
    5252 *
    5353 * @returns The CPU mode on success, CPUMMODE_INVALID on failure.
    54  * @param   pVM                 The VM handle.
     54 * @param   pVM                 Pointer to the VM.
    5555 * @param   idCpu               The target CPU ID.
    5656 */

  • trunk/src/VBox/VMM/VMMR3/DBGFDisas.cpp

    r41764 r41783  
    5050    /** The core structure. */
    5151    DISCPUSTATE     Cpu;
    52     /** The VM handle. */
     52    /** Pointer to the VM. */
    5353    PVM             pVM;
    5454    /** The VMCPU handle. */
    … …  
    322322 *
    323323 * @returns VBox status code.
    324  * @param       pVM             The VM handle.
     324 * @param       pVM             Pointer to the VM.
    325325 * @param       pVCpu           The virtual CPU handle.
    326326 * @param       Sel             The code selector. This used to determine the 32/16 bit ness and

  • trunk/src/VBox/VMM/VMMR3/DBGFInfo.cpp

    r39405 r41783  
    694694 *
    695695 * @returns VBox status code.
    696  * @param   pVM                 The VM handle.
     696 * @param   pVM                 Pointer to the VM.
    697697 * @param   idCpu               Which CPU to run EMT bound handlers on.
    698698 *                              VMCPUID_ANY or a valid CPU ID.
    … …  
    823823 *
    824824 * @returns See DBGFR3Info.
    825  * @param   pVM                 The VM handle.
     825 * @param   pVM                 Pointer to the VM.
    826826 * @param   pszName             See DBGFR3Info.
    827827 * @param   pszArgs             See DBGFR3Info.
    … …  
    837837 *
    838838 * @returns See DBGFR3Info.
    839  * @param   pVM                 The VM handle.
     839 * @param   pVM                 Pointer to the VM.
    840840 * @param   pszName             See DBGFR3Info.
    841841 * @param   pszArgs             See DBGFR3Info.
    … …  
    853853 *
    854854 * @returns
    855  * @param   pVM             The VM handle.
     855 * @param   pVM             Pointer to the VM.
    856856 * @param   pszIncludePat   Simple string pattern of info items to include.
    857857 * @param   pszExcludePat   Simple string pattern of info items to exclude.
    … …  
    985985 * Info handler, internal version.
    986986 *
    987  * @param   pVM         The VM handle.
     987 * @param   pVM         Pointer to the VM.
    988988 * @param   pHlp        Callback functions for doing output.
    989989 * @param   pszArgs     Argument string. Optional and specific to the handler.

  • trunk/src/VBox/VMM/VMMR3/DBGFLog.cpp

    r39650 r41783  
    6666 *
    6767 * @returns VBox status code.
    68  * @param   pVM                 The VM handle.
     68 * @param   pVM                 Pointer to the VM.
    6969 * @param   pszGroupSettings    The group settings string. (VBOX_LOG)
    7070 *                              By prefixing the string with \"release:\" the
    … …  
    8686 *
    8787 * @returns VBox status code.
    88  * @param   pVM                 The VM handle.
     88 * @param   pVM                 Pointer to the VM.
    8989 * @param   pszGroupSettings    The group settings string. (VBOX_LOG)
    9090 */
    … …  
    106106 *
    107107 * @returns VBox status code.
    108  * @param   pVM                 The VM handle.
     108 * @param   pVM                 Pointer to the VM.
    109109 * @param   pszFlagSettings     The group settings string. (VBOX_LOG_FLAGS)
    110110 *                              By prefixing the string with \"release:\" the
    … …  
    126126 *
    127127 * @returns VBox status code.
    128  * @param   pVM                 The VM handle.
     128 * @param   pVM                 Pointer to the VM.
    129129 * @param   pszFlagSettings     The group settings string. (VBOX_LOG_FLAGS)
    130130 */
    … …  
    146146 *
    147147 * @returns VBox status code.
    148  * @param   pVM                 The VM handle.
     148 * @param   pVM                 Pointer to the VM.
    149149 * @param   pszDestSettings     The destination settings string. (VBOX_LOG_DEST)
    150150 *                              By prefixing the string with \"release:\" the
    … …  
    166166 *
    167167 * @returns VBox status code.
    168  * @param   pVM                 The VM handle.
     168 * @param   pVM                 Pointer to the VM.
    169169 * @param   pszDestSettings     The destination settings string. (VBOX_LOG_DEST)
    170170 */

  • trunk/src/VBox/VMM/VMMR3/DBGFMem.cpp

    r41777 r41783  
    3737 *
    3838 * @returns VBox status code.
    39  * @param   pVM         The VM handle.
     39 * @param   pVM         Pointer to the VM.
    4040 * @param   idCpu       The ID of the CPU context to search in.
    4141 * @param   pAddress    Where to store the mixed address.
    … …  
    110110 * @retval  VERR_INVALID_ARGUMENT if any other arguments are invalid.
    111111 *
    112  * @param   pVM         The VM handle.
     112 * @param   pVM         Pointer to the VM.
    113113 * @param   idCpu       The ID of the CPU context to search in.
    114114 * @param   pAddress    Where to store the mixed address.
    … …  
    545545 *
    546546 * @returns VBox status code.
    547  * @param   pVM             The VM handle.
     547 * @param   pVM             Pointer to the VM.
    548548 * @param   idCpu           The current CPU ID.
    549549 * @param   fFlags          The flags, DBGFPGDMP_FLAGS_XXX.  Valid.
    … …  
    626626 *
    627627 * @returns VBox status code.
    628  * @param   pVM             The VM handle.
     628 * @param   pVM             Pointer to the VM.
    629629 * @param   idCpu           The current CPU ID.
    630630 * @param   fFlags          The flags, DBGFPGDMP_FLAGS_XXX.

  • trunk/src/VBox/VMM/VMMR3/DBGFR3Trace.cpp

    r40557 r41783  
    7070 *
    7171 * @returns VBox status code
    72  * @param   pVM                 The VM handle.
     72 * @param   pVM                 Pointer to the VM.
    7373 */
    7474static int dbgfR3TraceEnable(PVM pVM, uint32_t cbEntry, uint32_t cEntries)
    … …  
    134134 *
    135135 * @returns VBox status code
    136  * @param   pVM                 The VM handle.
     136 * @param   pVM                 Pointer to the VM.
    137137 */
    138138int dbgfR3TraceInit(PVM pVM)
    … …  
    190190 * Terminates the tracing.
    191191 *
    192  * @param   pVM                 The VM handle.
     192 * @param   pVM                 Pointer to the VM.
    193193 */
    194194void dbgfR3TraceTerm(PVM pVM)
    … …  
    202202 * Relocates the trace buffer handle in RC.
    203203 *
    204  * @param   pVM                 The VM handle.
     204 * @param   pVM                 Pointer to the VM.
    205205 */
    206206void dbgfR3TraceRelocate(PVM pVM)
    … …  
    222222 * @retval  VERR_INVALID_POINTER
    223223 *
    224  * @param   pVM         The VM handle.
     224 * @param   pVM         Pointer to the VM.
    225225 * @param   pszConfig   The configuration change specification.
    226226 *
    … …  
    349349 *          empty.
    350350
    351  * @param   pVM                 The VM handle.
     351 * @param   pVM                 Pointer to the VM.
    352352 * @param   pszConfig           Pointer to the output buffer.
    353353 * @param   cbConfig            The size of the output buffer.

  • trunk/src/VBox/VMM/VMMR3/DBGFReg.cpp

    r41545 r41783  
    174174typedef struct DBGFR3REGPRINTFARGS
    175175{
    176     /** The VM handle. */
     176    /** Pointer to the VM. */
    177177    PVM         pVM;
    178178    /** The target CPU. */
    … …  
    204204 *
    205205 * @returns VBox status code.
    206  * @param   pVM                 The VM handle.
     206 * @param   pVM                 Pointer to the VM.
    207207 */
    208208int dbgfR3RegInit(PVM pVM)
    … …  
    221221 * Terminates the register database.
    222222 *
    223  * @param   pVM                 The VM handle.
     223 * @param   pVM                 Pointer to the VM.
    224224 */
    225225void dbgfR3RegTerm(PVM pVM)
    … …  
    262262 *
    263263 * @returns VBox status code.
    264  * @param   pVM                 The VM handle.
     264 * @param   pVM                 Pointer to the VM.
    265265 * @param   paRegisters         The register descriptors.
    266266 * @param   enmType             The set type.
    … …  
    497497 *
    498498 * @returns VBox status code.
    499  * @param   pVM             The VM handle.
     499 * @param   pVM             Pointer to the VM.
    500500 * @param   pVCpu           The virtual CPU handle.
    501501 * @param   paRegisters     The register descriptors.
    … …  
    782782 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    783783 *
    784  * @param   pVM                 The VM handle.
     784 * @param   pVM                 Pointer to the VM.
    785785 * @param   idCpu               The virtual CPU ID.
    786786 * @param   enmReg              The register to query.
    … …  
    848848 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    849849 *
    850  * @param   pVM                 The VM handle.
     850 * @param   pVM                 Pointer to the VM.
    851851 * @param   idCpu               The virtual CPU ID.  Can be OR'ed with
    852852 *                              DBGFREG_HYPER_VMCPUID.
    … …  
    879879 * @retval  VINF_DBGF_TRUNCATED_REGISTER
    880880 *
    881  * @param   pVM                 The VM handle.
     881 * @param   pVM                 Pointer to the VM.
    882882 * @param   idCpu               The target CPU ID. Can be OR'ed with
    883883 *                              DBGFREG_HYPER_VMCPUID.
    … …  
    908908 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    909909 *
    910  * @param   pVM                 The VM handle.
     910 * @param   pVM                 Pointer to the VM.
    911911 * @param   idCpu               The target CPU ID.  Can be OR'ed with
    912912 *                              DBGFREG_HYPER_VMCPUID.
    … …  
    937937 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    938938 *
    939  * @param   pVM                 The VM handle.
     939 * @param   pVM                 Pointer to the VM.
    940940 * @param   idCpu               The target CPU ID.  Can be OR'ed with
    941941 *                              DBGFREG_HYPER_VMCPUID.
    … …  
    966966 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    967967 *
    968  * @param   pVM                 The VM handle.
     968 * @param   pVM                 Pointer to the VM.
    969969 * @param   idCpu               The target CPU ID.  Can be OR'ed with
    970970 *                              DBGFREG_HYPER_VMCPUID.
    … …  
    10711071 * @retval  VERR_DBGF_REGISTER_NOT_FOUND
    10721072 *
    1073  * @param   pVM                 The VM handle.
     1073 * @param   pVM                 Pointer to the VM.
    10741074 * @param   idCpu               The target CPU ID.  Can be OR'ed with
    10751075 *                              DBGFREG_HYPER_VMCPUID.
    … …  
    11071107 * @retval  VERR_INVALID_CPU_ID
    11081108 *
    1109  * @param   pVM                 The VM handle.
     1109 * @param   pVM                 Pointer to the VM.
    11101110 * @param   idCpu               The target CPU ID.  Can be OR'ed with
    11111111 *                              DBGFREG_HYPER_VMCPUID.
    … …  
    11531153 *          parameters are invalid.
    11541154 *
    1155  * @param   pVM                 The VM handle.
     1155 * @param   pVM                 Pointer to the VM.
    11561156 * @param   enmReg              The register identifier.
    11571157 * @param   enmType             The register type.  This is for sort out
    … …  
    12211221 *
    12221222 * @returns Lookup record.
    1223  * @param   pVM                 The VM handle.
     1223 * @param   pVM                 Pointer to the VM.
    12241224 * @param   idDefCpu            The default CPU ID set.
    12251225 * @param   pszReg              The register name.
    … …  
    12641264 * @retval  VERR_DBGF_REGISTER_NOT_FOUND if not found.
    12651265 *
    1266  * @param   pVM                 The VM handle.
     1266 * @param   pVM                 Pointer to the VM.
    12671267 * @param   idDefCpu            The default CPU.
    12681268 * @param   pszReg              The registe name.
    … …  
    12941294 * @returns VBox status code.
    12951295 *
    1296  * @param   pVM                 The VM handle.
     1296 * @param   pVM                 Pointer to the VM.
    12971297 * @param   pLookupRec          The register lookup record.
    12981298 * @param   enmType             The desired return type.
    … …  
    14091409 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    14101410 *
    1411  * @param   pVM                 The VM handle.
     1411 * @param   pVM                 Pointer to the VM.
    14121412 * @param   idDefCpu            The virtual CPU ID for the default CPU register
    14131413 *                              set.  Can be OR'ed with DBGFREG_HYPER_VMCPUID.
    … …  
    14561456 * @retval  VERR_DBGF_REGISTER_NOT_FOUND
    14571457 *
    1458  * @param   pVM                 The VM handle.
     1458 * @param   pVM                 Pointer to the VM.
    14591459 * @param   idDefCpu            The default target CPU ID, VMCPUID_ANY if not
    14601460 *                              applicable. Can be OR'ed with
    … …  
    14821482 * @retval  VINF_DBGF_TRUNCATED_REGISTER
    14831483 *
    1484  * @param   pVM                 The VM handle.
     1484 * @param   pVM                 Pointer to the VM.
    14851485 * @param   idDefCpu            The default target CPU ID, VMCPUID_ANY if not
    14861486 *                              applicable. Can be OR'ed with
    … …  
    15141514 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    15151515 *
    1516  * @param   pVM                 The VM handle.
     1516 * @param   pVM                 Pointer to the VM.
    15171517 * @param   idDefCpu            The default target CPU ID, VMCPUID_ANY if not
    15181518 *                              applicable.  Can be OR'ed with
    … …  
    15461546 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    15471547 *
    1548  * @param   pVM                 The VM handle.
     1548 * @param   pVM                 Pointer to the VM.
    15491549 * @param   idDefCpu            The default target CPU ID, VMCPUID_ANY if not
    15501550 *                              applicable.  Can be OR'ed with
    … …  
    15781578 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    15791579 *
    1580  * @param   pVM                 The VM handle.
     1580 * @param   pVM                 Pointer to the VM.
    15811581 * @param   idDefCpu            The default target CPU ID, VMCPUID_ANY if not
    15821582 *                              applicable.  Can be OR'ed with
    … …  
    16101610 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    16111611 *
    1612  * @param   pVM                 The VM handle.
     1612 * @param   pVM                 Pointer to the VM.
    16131613 * @param   idDefCpu            The default target CPU ID, VMCPUID_ANY if not
    16141614 *                              applicable.  Can be OR'ed with
    … …  
    16431643 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    16441644 *
    1645  * @param   pVM                 The VM handle.
     1645 * @param   pVM                 Pointer to the VM.
    16461646 * @param   idDefCpu            The default target CPU ID, VMCPUID_ANY if not
    16471647 *                              applicable.  Can be OR'ed with
    … …  
    16761676 * @retval  VINF_DBGF_ZERO_EXTENDED_REGISTER
    16771677 *
    1678  * @param   pVM                 The VM handle.
     1678 * @param   pVM                 Pointer to the VM.
    16791679 * @param   idDefCpu            The default target CPU ID, VMCPUID_ANY if not
    16801680 *                              applicable.  Can be OR'ed with
    … …  
    17111711 *
    17121712 * @returns VBox status code.
    1713  * @param   pVM                 The VM handle.
     1713 * @param   pVM                 Pointer to the VM.
    17141714 * @param   pcRegs              Where to return the register count.
    17151715 */
    … …  
    18491849 *
    18501850 * @returns VBox status code.
    1851  * @param   pVM                 The VM handle.
     1851 * @param   pVM                 Pointer to the VM.
    18521852 * @param   paRegs              The output register value array.  The register
    18531853 *                              name string is read only and shall not be freed
    … …  
    22832283 *
    22842284 * @returns VBox status code.
    2285  * @param   pVM                 The VM handle.
     2285 * @param   pVM                 Pointer to the VM.
    22862286 * @param   idCpu               The CPU ID of any CPU registers that may be
    22872287 *                              printed, pass VMCPUID_ANY if not applicable.
    … …  
    23282328 *
    23292329 * @returns VBox status code.
    2330  * @param   pVM                 The VM handle.
     2330 * @param   pVM                 Pointer to the VM.
    23312331 * @param   idCpu               The CPU ID of any CPU registers that may be
    23322332 *                              printed, pass VMCPUID_ANY if not applicable.

  • trunk/src/VBox/VMM/VMMR3/DBGFStack.cpp

    r39405 r41783  
    470470 * @returns VERR_NO_MEMORY if we're out of memory.
    471471 *
    472  * @param   pVM             The VM handle.
     472 * @param   pVM             Pointer to the VM.
    473473 * @param   idCpu           The ID of the virtual CPU which stack we want to walk.
    474474 * @param   enmCodeType     Code type
    … …  
    502502 * @returns VERR_NO_MEMORY if we're out of memory.
    503503 *
    504  * @param   pVM             The VM handle.
     504 * @param   pVM             Pointer to the VM.
    505505 * @param   idCpu           The ID of the virtual CPU which stack we want to walk.
    506506 * @param   enmCodeType     Code type
    … …  
    535535 * walker functions. If not called we will leak memory or other resources.
    536536 *
    537  * @param   pFirstFrame     The frame returned by one of the the begin
    538  *                          functions.
     537 * @param   pFirstFrame     The frame returned by one of the begin functions.
    539538 */
    540539VMMR3DECL(void) DBGFR3StackWalkEnd(PCDBGFSTACKFRAME pFirstFrame)

  • trunk/src/VBox/VMM/VMMR3/DBGFSym.cpp

    r39477 r41783  
    242242 *
    243243 * @returns VBox status code.
    244  * @param   pVM     The VM handle.
     244 * @param   pVM     Pointer to the VM.
    245245 */
    246246int dbgfR3SymInit(PVM pVM)
    … …  
    610610 *
    611611 * @returns VBox status code.
    612  * @param   pVM             The VM handle.
     612 * @param   pVM             Pointer to the VM.
    613613 * @param   pszFilename     The name of the file to locate and open.
    614614 * @param   pszFound        Where to return the actual filename.
    … …  
    800800 * Interface used by PDMR3LdrRelocate for telling us that a GC module has been relocated.
    801801 *
    802  * @param   pVM             The VM handle.
     802 * @param   pVM             Pointer to the VM.
    803803 * @param   OldImageBase    The old image base.
    804804 * @param   NewImageBase    The new image base.
    … …  
    10671067 *
    10681068 * @returns VBox status code.
    1069  * @param   pVM             The VM handle.
     1069 * @param   pVM             Pointer to the VM.
    10701070 * @param   pLine           The line to duplicate.
    10711071 */

  • trunk/src/VBox/VMM/VMMR3/EM.cpp

    r41774 r41783  
    459459 * Reset notification.
    460460 *
    461  * @param   pVM                 The VM handle.
     461 * @param   pVM                 Pointer to the VM.
    462462 */
    463463VMMR3DECL(void) EMR3Reset(PVM pVM)
    … …  
    927927 *
    928928 * @returns false - new fInREMState value.
    929  * @param   pVM         The VM handle.
     929 * @param   pVM         Pointer to the VM.
    930930 * @param   pVCpu       The virtual CPU handle.
    931931 */

  • trunk/src/VBox/VMM/VMMR3/EMHwaccm.cpp

    r41737 r41783  
    7676 *
    7777 * @returns VBox status code.
    78  * @param   pVM     The VM handle.
     78 * @param   pVM     Pointer to the VM.
    7979 * @param   pVCpu   The VMCPU handle.
    8080 */
    … …  
    388388 * @returns VBox status code. May return VINF_EM_NO_MEMORY but none of the other
    389389 *          EM statuses.
    390  * @param   pVM         The VM handle.
     390 * @param   pVM         Pointer to the VM.
    391391 * @param   pVCpu       The VMCPU handle.
    392392 * @param   pCtx        The guest CPUM register context.

  • trunk/src/VBox/VMM/VMMR3/EMRaw.cpp

    r41744 r41783  
    115115 *
    116116 * @returns VBox status code.
    117  * @param   pVM     The VM handle.
     117 * @param   pVM     Pointer to the VM.
    118118 * @param   pVCpu   The VMCPU handle.
    119119 */
    … …  
    149149 *
    150150 * @returns VBox status code.
    151  * @param   pVM     The VM handle.
     151 * @param   pVM     Pointer to the VM.
    152152 * @param   pVCpu   The VMCPU handle.
    153153 */
    … …  
    11591159 * @returns Updated rc.
    11601160 *
    1161  * @param   pVM     The VM handle.
     1161 * @param   pVM     Pointer to the VM.
    11621162 * @param   pVCpu   The VMCPU handle.
    11631163 * @param   pCtx    The guest CPU context.
    … …  
    12081208 * @returns VBox status code. May return VINF_EM_NO_MEMORY but none of the other
    12091209 *          EM statuses.
    1210  * @param   pVM         The VM handle.
     1210 * @param   pVM         Pointer to the VM.
    12111211 * @param   pVCpu       The VMCPU handle.
    12121212 * @param   pCtx        The guest CPUM register context.

  • trunk/src/VBox/VMM/VMMR3/FTM.cpp

    r39078 r41783  
    616616 * VMR3ReqCallWait callback
    617617 *
    618  * @param   pVM         The VM handle.
     618 * @param   pVM         Pointer to the VM.
    619619 *
    620620 */
    … …  
    630630 *
    631631 * @returns VBox status code.
    632  * @param   pVM         The VM handle.
     632 * @param   pVM         Pointer to the VM.
    633633 */
    634634static int ftmR3PerformFullSync(PVM pVM)
    … …  
    731731 *
    732732 * @param   hThread     The thread handle.
    733  * @param   pvUser      The VM handle.
     733 * @param   pvUser      Pointer to the VM.
    734734 * @return  VINF_SUCCESS (ignored).
    735735 *
    … …  
    912912 * @returns 0 to continue, otherwise stop
    913913 * @param   pBaseNode       Node to destroy
    914  * @param   pvUser          The VM handle.
     914 * @param   pvUser          Pointer to the VM.
    915915 */
    916916static DECLCALLBACK(int) ftmR3PageTreeDestroyCallback(PAVLGCPHYSNODECORE pBaseNode, void *pvUser)
    … …  
    933933 *
    934934 * @param   hThread     The thread handle.
    935  * @param   pvUser      The VM handle.
     935 * @param   pvUser      Pointer to the VM.
    936936 * @return  VINF_SUCCESS (ignored).
    937937 *
    … …  
    12311231 *
    12321232 * @returns VINF_SUCCESS (VBox strict status code).
    1233  * @param   pVM         The VM handle.
     1233 * @param   pVM         Pointer to the VM.
    12341234 * @param   pVCpu       The VMCPU for the EMT we're being called on. Unused.
    12351235 * @param   pvUser      Not used.

  • trunk/src/VBox/VMM/VMMR3/HWACCM.cpp

    r41775 r41783  
    694694 *
    695695 * @returns VBox status code.
    696  * @param   pVM         The VM handle.
     696 * @param   pVM         Pointer to the VM.
    697697 */
    698698static int hwaccmR3InitFinalizeR0(PVM pVM)
    … …  
    16571657 *
    16581658 * @returns VBox strict status code.
    1659  * @param   pVM     The VM handle.
     1659 * @param   pVM     Pointer to the VM.
    16601660 * @param   pVCpu   The VMCPU for the EMT we're being called on.
    16611661 * @param   pvUser  Unused
    … …  
    17921792 *
    17931793 * @returns VBox strict status code.
    1794  * @param   pVM     The VM handle.
     1794 * @param   pVM     Pointer to the VM.
    17951795 * @param   pVCpu   The VMCPU for the EMT we're being called on.
    17961796 * @param   pvUser  User specified CPU context
    … …  
    19641964 *
    19651965 * @returns VBox strict status code.
    1966  * @param   pVM     The VM handle.
     1966 * @param   pVM     Pointer to the VM.
    19671967 * @param   pVCpu   The VMCPU for the EMT we're being called on.
    19681968 * @param   pvUser  User specified CPU context
    … …  
    25092509 *
    25102510 * @returns true if it is, false if it isn't.
    2511  * @param   pVM         The VM handle.
     2511 * @param   pVM         Pointer to the VM.
    25122512 */
    25132513VMMR3DECL(bool) HWACCMR3IsVmxPreemptionTimerUsed(PVM pVM)

  • trunk/src/VBox/VMM/VMMR3/MM.cpp

    r39078 r41783  
    782782 *
    783783 * @returns The guest base RAM size.
    784  * @param   pVM         The VM handle.
     784 * @param   pVM         Pointer to the VM.
    785785 * @thread  Any.
    786786 *

  • trunk/src/VBox/VMM/VMMR3/MMHeap.cpp

    r35346 r41783  
    540540 * @returns Pointer to the duplicate.
    541541 * @returns NULL on failure or when input NULL.
    542  * @param   pVM         The VM handle.
     542 * @param   pVM         Pointer to the VM.
    543543 * @param   enmTag      Statistics tag. Statistics are collected on a per tag
    544544 *                      basis in addition to a global one. Thus we can easily

  • trunk/src/VBox/VMM/VMMR3/MMHyper.cpp

    r41777 r41783  
    4949 *
    5050 * @returns The heap size in bytes.
    51  * @param   pVM     The VM handle.
     51 * @param   pVM     Pointer to the VM.
    5252 */
    5353static uint32_t mmR3ComputeHyperHeapSize(PVM pVM)
    … …  
    326326 * @returns true if the location is ok.
    327327 * @returns false if another location should be found.
    328  * @param   pVM         The VM handle.
     328 * @param   pVM         Pointer to the VM.
    329329 * @param   GCPtrOld    The old virtual address.
    330330 * @param   GCPtrNew    The new virtual address.
    … …  
    389389 *
    390390 * @returns VBox status code.
    391  * @param   pVM     The VM handle.
     391 * @param   pVM     Pointer to the VM.
    392392 */
    393393VMMR3DECL(int) MMR3LockCall(PVM pVM)
    … …  
    728728 *
    729729 * @return VBox status code.
    730  * @param   pVM         The VM handle.
     730 * @param   pVM         Pointer to the VM.
    731731 * @param   cb          Size of the memory. Will be rounded up to nearest page.
    732732 * @param   pszDesc     The description of the memory.
    … …  
    788788 *
    789789 * @returns VBox status code.
    790  * @param   pVM         The VM handle.
     790 * @param   pVM         Pointer to the VM.
    791791 * @param   cb          The size of the new heap.
    792792 * @param   ppHeap      Where to store the heap pointer on successful return.
    … …  
    10701070 *
    10711071 * @returns The lookup record on success, NULL on failure.
    1072  * @param   pVM                 The VM handle.
     1072 * @param   pVM                 Pointer to the VM.
    10731073 * @param   pvR3                The ring-3 address to look up.
    10741074 */
    … …  
    11191119 *
    11201120 * @returns VBox status code (first failure).
    1121  * @param   pVM                 The VM handle.
     1121 * @param   pVM                 Pointer to the VM.
    11221122 * @param   pvStart             The hyper heap page address. Must be page
    11231123 *                              aligned.
    … …  
    12181218 *
    12191219 * @returns VINF_SUCCESS, VINF_BUFFER_OVERFLOW.
    1220  * @param   pVM                 The VM handle.
     1220 * @param   pVM                 Pointer to the VM.
    12211221 * @param   HCPhys              The host physical address to look for.
    12221222 * @param   pLookup             The HMA lookup entry corresponding to HCPhys.
    … …  
    12391239 *
    12401240 * @returns VINF_SUCCESS, VINF_BUFFER_OVERFLOW, VERR_NOT_FOUND.
    1241  * @param   pVM                 The VM handle.
     1241 * @param   pVM                 Pointer to the VM.
    12421242 * @param   HCPhys              The host physical address to look for.
    12431243 * @param   pszWhat             Where to return the description.
    … …  
    13591359 * Info handler for 'hma', it dumps the list of lookup records for the hypervisor memory area.
    13601360 *
    1361  * @param   pVM         The VM handle.
     1361 * @param   pVM         Pointer to the VM.
    13621362 * @param   pHlp        Callback functions for doing output.
    13631363 * @param   pszArgs     Argument string. Optional and specific to the handler.

  • trunk/src/VBox/VMM/VMMR3/MMUkHeap.cpp

    r35346 r41783  
    376376 * Releases memory allocated with MMR3UkHeapAlloc() and MMR3UkHeapAllocZ()
    377377 *
    378  * @param   pVM         The VM handle.
     378 * @param   pVM         Pointer to the VM.
    379379 * @param   pv          Pointer to the memory block to free.
    380380 */

  • trunk/src/VBox/VMM/VMMR3/PATM.cpp

    r41771 r41783  
    306306 *
    307307 * @returns VBox status code.
    308  * @param   pVM     The VM handle.
     308 * @param   pVM     Pointer to the VM.
    309309 */
    310310VMMR3DECL(int) PATMR3InitFinalize(PVM pVM)
    … …  
    66806680/**
    66816681 * Resets the sample.
    6682  * @param   pVM         The VM handle.
     6682 * @param   pVM         Pointer to the VM.
    66836683 * @param   pvSample    The sample registered using STAMR3RegisterCallback.
    66846684 */
    … …  
    66956695 * Prints the sample into the buffer.
    66966696 *
    6697  * @param   pVM         The VM handle.
     6697 * @param   pVM         Pointer to the VM.
    66986698 * @param   pvSample    The sample registered using STAMR3RegisterCallback.
    66996699 * @param   pszBuf      The buffer to print into.

  • trunk/src/VBox/VMM/VMMR3/PDM.cpp

    r41777 r41783  
    298298typedef struct PDMNOTIFYASYNCSTATS
    299299{
    300     /** The the start timestamp. */
     300    /** The start timestamp. */
    301301    uint64_t        uStartNsTs;
    302302    /** When to log the next time. */
    … …  
    729729 * Bits that are saved in pass 0 and in the final pass.
    730730 *
    731  * @param   pVM             The VM handle.
     731 * @param   pVM             Pointer to the VM.
    732732 * @param   pSSM            The saved state handle.
    733733 */
    … …  
    753753 *
    754754 * @returns VBox status code.
    755  * @param   pVM             The VM handle.
     755 * @param   pVM             Pointer to the VM.
    756756 * @param   pSSM            The saved state handle.
    757757 * @param   uPass           The pass.
    … …  
    770770 *
    771771 * @returns VBox status code.
    772  * @param   pVM             The VM handle.
     772 * @param   pVM             Pointer to the VM.
    773773 * @param   pSSM            The saved state handle.
    774774 */
    … …  
    801801 *
    802802 * @returns VBox status code.
    803  * @param   pVM         The VM handle.
     803 * @param   pVM         Pointer to the VM.
    804804 * @param   pSSM        The SSM handle.
    805805 */
    … …  
    12561256 *
    12571257 * @param   pThis               The asynchronous notifification stats.
    1258  * @param   pVM                 The VM handle.
     1258 * @param   pVM                 Pointer to the VM.
    12591259 */
    12601260static void pdmR3NotifyAsyncWaitAndProcessRequests(PPDMNOTIFYASYNCSTATS pThis, PVM pVM)
    … …  
    16471647 * the VM now being suspended.
    16481648 *
    1649  * @param   pVM     The VM Handle.
     1649 * @param   pVM     Pointer to the VM.
    16501650 * @thread  EMT(0)
    16511651 */
    … …  
    22892289 *
    22902290 * @returns VBox status code.
    2291  * @param   pVM     The VM handle.
     2291 * @param   pVM     Pointer to the VM.
    22922292 */
    22932293VMMR3DECL(int) PDMR3LockCall(PVM pVM)
    … …  
    23872387 *
    23882388 * @returns VINF_SUCCESS or VERR_NOT_FOUND.
    2389  * @param   pVM                 The VM handle.
     2389 * @param   pVM                 Pointer to the VM.
    23902390 * @param   pszName             The tracing config group name.  This is NULL if
    23912391 *                              the operation applies to every device and
    … …  
    25232523 *
    25242524 * @returns true / false.
    2525  * @param   pVM                 The VM handle.
     2525 * @param   pVM                 Pointer to the VM.
    25262526 * @param   fEnabled            The tracing setting to check for.
    25272527 */
    … …  
    25612561 *
    25622562 * @returns VINF_SUCCESS or VERR_BUFFER_OVERFLOW
    2563  * @param   ppszDst             The pointer to the the output buffer pointer.
     2563 * @param   ppszDst             The pointer to the output buffer pointer.
    25642564 * @param   pcbDst              The pointer to the output buffer size.
    25652565 * @param   fSpace              Whether to add a space before the name.
    … …  
    25992599 *
    26002600 * @returns VINF_SUCCESS or VERR_BUFFER_OVERFLOW
    2601  * @param   pVM                 The VM handle.
     2601 * @param   pVM                 Pointer to the VM.
    26022602 * @param   pszConfig           Where to store the config spec.
    26032603 * @param   cbConfig            The size of the output buffer.
    … …  
    26762676 * Info handler for 'pdmtracingids'.
    26772677 *
    2678  * @param   pVM         The VM handle.
     2678 * @param   pVM         Pointer to the VM.
    26792679 * @param   pHlp        The output helpers.
    26802680 * @param   pszArgs     The optional user arguments.

  • trunk/src/VBox/VMM/VMMR3/PDMAsyncCompletion.cpp

    r41777 r41783  
    769769 * @param   pVM        Pointer to the shared VM instance data.
    770770 * @param   pEpClass   Pointer to the endpoint class structure.
    771  * @param   pCfgHandle Pointer to the the CFGM tree.
     771 * @param   pCfgHandle Pointer to the CFGM tree.
    772772 */
    773773int pdmR3AsyncCompletionEpClassInit(PVM pVM, PCPDMASYNCCOMPLETIONEPCLASSOPS pEpClassOps, PCFGMNODE pCfgHandle)

  • trunk/src/VBox/VMM/VMMR3/PDMCritSect.cpp

    r39402 r41783  
    4848 *
    4949 * @returns VBox status code.
    50  * @param   pVM         The VM handle.
     50 * @param   pVM         Pointer to the VM.
    5151 */
    5252int pdmR3CritSectInitStats(PVM pVM)
    … …  
    6161 * Relocates all the critical sections.
    6262 *
    63  * @param   pVM         The VM handle.
     63 * @param   pVM         Pointer to the VM.
    6464 */
    6565void pdmR3CritSectRelocate(PVM pVM)
    … …  
    114114 *
    115115 * @returns VBox status code.
    116  * @param   pVM             The Vm handle.
     116 * @param   pVM             Pointer to the VM.
    117117 * @param   pCritSect       The critical section.
    118118 * @param   pvKey           The owner key.
    … …  
    197197 *
    198198 * @returns VBox status code.
    199  * @param   pVM             The VM handle.
     199 * @param   pVM             Pointer to the VM.
    200200 * @param   pDevIns         Device instance.
    201201 * @param   pCritSect       Pointer to the critical section.
    … …  
    227227 *
    228228 * @returns VBox status code.
    229  * @param   pVM             The VM handle.
     229 * @param   pVM             Pointer to the VM.
    230230 * @param   pDevIns         Device instance.
    231231 * @param   pCritSect       Pointer to the critical section.
    … …  
    245245 *
    246246 * @returns VBox status code.
    247  * @param   pVM             The VM handle.
     247 * @param   pVM             Pointer to the VM.
    248248 * @param   pDevIns         Device instance.
    249249 * @param   pCritSect       Pointer to the critical section.
    … …  
    266266 *
    267267 * @returns VBox status code.
    268  * @param   pVM             The VM handle.
     268 * @param   pVM             Pointer to the VM.
    269269 * @param   pDrvIns         Driver instance.
    270270 * @param   pCritSect       Pointer to the critical section.
    … …  
    289289 * @returns Return code from RTCritSectDelete.
    290290 *
    291  * @param   pVM         The VM handle.
     291 * @param   pVM         Pointer to the VM.
    292292 * @param   pCritSect   The critical section.
    293293 * @param   pPrev       The previous critical section in the list.
    … …  
    355355 *          return the first error code. This shouldn't be a problem
    356356 *          since errors really shouldn't happen here.
    357  * @param   pVM     The VM handle.
     357 * @param   pVM     Pointer to the VM.
    358358 * @param   pvKey   The initializer key.
    359359 */
    … …  
    391391 *
    392392 * @returns VBox status code.
    393  * @param   pVM         The VM handle.
     393 * @param   pVM         Pointer to the VM.
    394394 * @param   pDevIns     The device handle.
    395395 */
    … …  
    404404 *
    405405 * @returns VBox status code.
    406  * @param   pVM         The VM handle.
     406 * @param   pVM         Pointer to the VM.
    407407 * @param   pDrvIns     The driver handle.
    408408 */
    … …  
    564564 * @returns Lock count.
    565565 *
    566  * @param   pVM             The VM handle.
     566 * @param   pVM             Pointer to the VM.
    567567 * @param   pszNames        Where to return the critical section names.
    568568 * @param   cbNames         The size of the buffer.
    … …  
    648648 * EMTs and I/O threads from deadlocking.
    649649 *
    650  * @param   pVM         The VM handle.
     650 * @param   pVM         Pointer to the VM.
    651651 */
    652652VMMR3DECL(void) PDMR3CritSectLeaveAll(PVM pVM)
    … …  
    675675 *
    676676 * @returns The address of the NOP critical section.
    677  * @param   pVM                 The VM handle.
     677 * @param   pVM                 Pointer to the VM.
    678678 */
    679679VMMR3DECL(PPDMCRITSECT)             PDMR3CritSectGetNop(PVM pVM)
    … …  
    688688 *
    689689 * @returns The ring-0 address of the NOP critical section.
    690  * @param   pVM                 The VM handle.
     690 * @param   pVM                 Pointer to the VM.
    691691 */
    692692VMMR3DECL(R0PTRTYPE(PPDMCRITSECT))  PDMR3CritSectGetNopR0(PVM pVM)
    … …  
    701701 *
    702702 * @returns The raw-mode context address of the NOP critical section.
    703  * @param   pVM                 The VM handle.
     703 * @param   pVM                 Pointer to the VM.
    704704 */
    705705VMMR3DECL(RCPTRTYPE(PPDMCRITSECT))  PDMR3CritSectGetNopRC(PVM pVM)

  • trunk/src/VBox/VMM/VMMR3/PDMDevHlp.cpp

    r40907 r41783  
    31653165 *
    31663166 * @returns VBox status code fit for scheduling.
    3167  * @param   pVM                 The VM handle.
     3167 * @param   pVM                 Pointer to the VM.
    31683168 * @param   pDevIns             The device that triggered this action.
    31693169 */
    … …  
    36363636 * @returns Success indicator.
    36373637 *          If false the item will not be removed and the flushing will stop.
    3638  * @param   pVM         The VM handle.
     3638 * @param   pVM         Pointer to the VM.
    36393639 * @param   pItem       The item to consume. Upon return this item will be freed.
    36403640 */

  • trunk/src/VBox/VMM/VMMR3/PDMDevice.cpp

    r41777 r41783  
    853853 *
    854854 * @returns Pointer to the critical section.
    855  * @param   pVM             The VM handle.
     855 * @param   pVM             Pointer to the VM.
    856856 * @param   pDevIns         The device instance in question.
    857857 *

  • trunk/src/VBox/VMM/VMMR3/PDMDriver.cpp

    r40920 r41783  
    377377 *
    378378 * @returns VBox status code.
    379  * @param   pVM                 The VM handle.
     379 * @param   pVM                 Pointer to the VM.
    380380 * @param   pDrvAbove           The driver above, NULL if top.
    381381 * @param   pLun                The LUN.
    … …  
    620620 * @returns VBox status code, including informational statuses.
    621621 *
    622  * @param   pVM                 The VM handle.
     622 * @param   pVM                 Pointer to the VM.
    623623 * @param   pNode               The CFGM node for the driver.
    624624 * @param   pBaseInterface      The base interface.

  • trunk/src/VBox/VMM/VMMR3/PDMLdr.cpp

    r41147 r41783  
    113113 * This will unload and free all modules.
    114114 *
    115  * @param   pVM         The VM handle.
     115 * @param   pVM         Pointer to the VM.
    116116 *
    117117 * @remarks This is normally called twice during termination.
    … …  
    432432
    433433/**
    434  * Loads a module into the raw-mode context (i.e. into the Hypervisor memory 
    435  * region). 
     434 * Loads a module into the raw-mode context (i.e. into the Hypervisor memory
     435 * region).
    436436 *
    437437 * @returns VBox status code.
    … …  
    535535                             */
    536536                            RTLDRADDR uValue;
    537                             rc = RTLdrGetSymbolEx(pModule->hLdrMod, pModule->pvBits, pModule->ImageBase, 
     537                            rc = RTLdrGetSymbolEx(pModule->hLdrMod, pModule->pvBits, pModule->ImageBase,
    538538                                                  "g_VTGObjHeader", &uValue);
    539539                            if (RT_SUCCESS(rc))
    540540                            {
    541541                                PVTGOBJHDR pVtgHdr = (PVTGOBJHDR)MMHyperRCToCC(pVM, (RTRCPTR)uValue);
    542                                 if (   pVtgHdr 
     542                                if (   pVtgHdr
    543543                                    && !memcmp(pVtgHdr->szMagic, VTGOBJHDR_MAGIC, sizeof(pVtgHdr->szMagic)))
    544                                     rc = SUPR3TracerRegisterModule(~(uintptr_t)0, pModule->szName, pVtgHdr, uValue, 
     544                                    rc = SUPR3TracerRegisterModule(~(uintptr_t)0, pModule->szName, pVtgHdr, uValue,
    545545                                                                   SUP_TRACER_UMOD_FLAGS_SHARED);
    546546                                else
    … …  
    15131513 *
    15141514 * @returns VBox status code.
    1515  * @param   pVM             The VM handle.
     1515 * @param   pVM             Pointer to the VM.
    15161516 * @param   pvInterface     Pointer to the interface structure.  The symbol list
    15171517 *                          describes the layout.

  • trunk/src/VBox/VMM/VMMR3/PDMNetShaper.cpp

    r41777 r41783  
    404404 *
    405405 * @returns VINF_SUCCESS (ignored).
    406  * @param   pVM         The VM handle.
     406 * @param   pVM         Pointer to the VM.
    407407 * @param   pThread     The PDM thread data.
    408408 */

  • trunk/src/VBox/VMM/VMMR3/PDMQueue.cpp

    r41774 r41783  
    597597 * Relocate the queues.
    598598 *
    599  * @param   pVM             The VM handle.
     599 * @param   pVM             Pointer to the VM.
    600600 * @param   offDelta        The relocation delta.
    601601 */

  • trunk/src/VBox/VMM/VMMR3/PDMThread.cpp

    r39402 r41783  
    9898 *
    9999 * @returns VBox status code.
    100  * @param   pVM         The VM handle.
     100 * @param   pVM         Pointer to the VM.
    101101 * @param   ppThread    Where to store the pointer to the instance.
    102102 */
    … …  
    123123 *
    124124 * @returns VBox status code.
    125  * @param   pVM         The VM handle.
     125 * @param   pVM         Pointer to the VM.
    126126 * @param   ppThread    Where the thread instance data handle is.
    127127 * @param   cbStack     The stack size, see RTThreadCreate().
    … …  
    196196 *
    197197 * @returns VBox status code.
    198  * @param   pVM         The VM handle.
     198 * @param   pVM         Pointer to the VM.
    199199 * @param   pDevIns     The device instance.
    200200 * @param   ppThread    Where to store the thread 'handle'.
    … …  
    229229 *
    230230 * @returns VBox status code.
    231  * @param   pVM         The VM handle.
     231 * @param   pVM         Pointer to the VM.
    232232 * @param   pUsbIns     The USB device instance.
    233233 * @param   ppThread    Where to store the thread 'handle'.
    … …  
    262262 *
    263263 * @returns VBox status code.
    264  * @param   pVM         The VM handle.
     264 * @param   pVM         Pointer to the VM.
    265265 * @param   pDrvIns     The driver instance.
    266266 * @param   ppThread    Where to store the thread 'handle'.
    … …  
    295295 *
    296296 * @returns VBox status code.
    297  * @param   pVM         The VM handle.
     297 * @param   pVM         Pointer to the VM.
    298298 * @param   ppThread    Where to store the thread 'handle'.
    299299 * @param   pvUser      The user argument to the thread function.
    … …  
    326326 *
    327327 * @returns VBox status code.
    328  * @param   pVM         The VM handle.
     328 * @param   pVM         Pointer to the VM.
    329329 * @param   ppThread    Where to store the thread 'handle'.
    330330 * @param   pvUser      The user argument to the thread function.
    … …  
    474474 *
    475475 * @returns VBox status code of the first failure.
    476  * @param   pVM         The VM handle.
     476 * @param   pVM         Pointer to the VM.
    477477 * @param   pDevIns     the device instance.
    478478 */
    … …  
    509509 *
    510510 * @returns VBox status code of the first failure.
    511  * @param   pVM         The VM handle.
     511 * @param   pVM         Pointer to the VM.
    512512 * @param   pUsbIns     The USB device instance.
    513513 */
    … …  
    544544 *
    545545 * @returns VBox status code of the first failure.
    546  * @param   pVM         The VM handle.
     546 * @param   pVM         Pointer to the VM.
    547547 * @param   pDrvIns     The driver instance.
    548548 */
    … …  
    576576 * Called For VM power off.
    577577 *
    578  * @param   pVM         The VM handle.
     578 * @param   pVM         Pointer to the VM.
    579579 */
    580580void pdmR3ThreadDestroyAll(PVM pVM)
    … …  
    971971 *
    972972 * @return VBox status code.
    973  * @param   pVM         The VM handle.
     973 * @param   pVM         Pointer to the VM.
    974974 */
    975975int pdmR3ThreadSuspendAll(PVM pVM)
    … …  
    10631063 *
    10641064 * @return VBox status code.
    1065  * @param   pVM         The VM handle.
     1065 * @param   pVM         Pointer to the VM.
    10661066 */
    10671067int pdmR3ThreadResumeAll(PVM pVM)

  • trunk/src/VBox/VMM/VMMR3/PDMUsb.cpp

    r41777 r41783  
    101101 *
    102102 * @returns VBox status code.
    103  * @param   pVM             The VM handle.
     103 * @param   pVM             Pointer to the VM.
    104104 * @param   pDrvIns         The driver instance of the hub.
    105105 * @param   fVersions       Indicates the kinds of USB devices that can be attached to this HUB.
    … …  
    276276 *
    277277 * @returns VBox status code.
    278  * @param   pVM         The VM handle.
     278 * @param   pVM         Pointer to the VM.
    279279 */
    280280int pdmR3UsbLoadModules(PVM pVM)
    … …  
    386386 *
    387387 * @returns VBox status code.
    388  * @param   pVM         The VM handle.
     388 * @param   pVM         Pointer to the VM.
    389389 */
    390390int pdmR3UsbVMInitComplete(PVM pVM)
    … …  
    427427 * @returns VINF_SUCCESS and *ppHub on success.
    428428 *          VERR_PDM_NO_USB_HUBS or VERR_PDM_NO_USB_PORTS on failure.
    429  * @param   pVM             The VM handle.
     429 * @param   pVM             Pointer to the VM.
    430430 * @param   iUsbVersion     The USB device version.
    431431 * @param   ppHub           Where to store the pointer to the USB hub.
    … …  
    456456 *
    457457 * @returns VBox status code.
    458  * @param   pVM             The VM handle.
     458 * @param   pVM             Pointer to the VM.
    459459 * @param   pUsbDev         The USB device emulation.
    460460 * @param   iInstance       -1 if not called by pdmR3UsbInstantiateDevices().
    … …  
    838838 *
    839839 * @returns VBox status code.
    840  * @param   pVM             The VM handle.
     840 * @param   pVM             Pointer to the VM.
    841841 * @param   pUuid           The UUID to be associated with the device.
    842842 * @param   fRemote         Whether it's a remove or local device.
    … …  
    10101010 *
    10111011 * @returns VBox status code.
    1012  * @param   pVM             The VM handle.
     1012 * @param   pVM             Pointer to the VM.
    10131013 * @param   pUuid           The UUID associated with the device to detach.
    10141014 * @thread  EMT

  • trunk/src/VBox/VMM/VMMR3/PGM.cpp

    r41470 r41783  
    21142114 *
    21152115 * @returns VBox status code.
    2116  * @param   pVM         The VM handle.
     2116 * @param   pVM         Pointer to the VM.
    21172117 */
    21182118VMMR3DECL(int) PGMR3InitFinalize(PVM pVM)
    … …  
    22312231 *
    22322232 * @returns VBox status code.
    2233  * @param   pVM                 The VM handle.
     2233 * @param   pVM                 Pointer to the VM.
    22342234 * @param   enmWhat             What has been completed.
    22352235 * @thread  EMT(0)
    … …  
    24682468 * Resets a virtual CPU when unplugged.
    24692469 *
    2470  * @param   pVM                 The VM handle.
     2470 * @param   pVM                 Pointer to the VM.
    24712471 * @param   pVCpu               The virtual CPU handle.
    24722472 */
    … …  
    27662766 *
    27672767 * @returns VBox status code.
    2768  * @param   pVM     The VM handle.
     2768 * @param   pVM     Pointer to the VM.
    27692769 */
    27702770VMMR3DECL(int) PGMR3LockCall(PVM pVM)
    … …  
    28452845 * Initializes the paging mode data kept in PGM::paModeData.
    28462846 *
    2847  * @param   pVM             The VM handle.
     2847 * @param   pVM             Pointer to the VM.
    28482848 * @param   fResolveGCAndR0 Indicate whether or not GC and Ring-0 symbols can be resolved now.
    28492849 *                          This is used early in the init process to avoid trouble with PDM
    … …  
    30573057 * Switch to different (or relocated in the relocate case) mode data.
    30583058 *
    3059  * @param   pVM         The VM handle.
     3059 * @param   pVM         Pointer to the VM.
    30603060 * @param   pVCpu       The VMCPU to operate on.
    3061  * @param   enmShw      The the shadow paging mode.
    3062  * @param   enmGst      The the guest paging mode.
     3061 * @param   enmShw      The shadow paging mode.
     3062 * @param   enmGst      The guest paging mode.
    30633063 */
    30643064static void pgmR3ModeDataSwitch(PVM pVM, PVMCPU pVCpu, PGMMODE enmShw, PGMMODE enmGst)
    … …  
    36473647 *
    36483648 * @returns VBox status code, fully asserted.
    3649  * @param   pVM     The VM handle.
     3649 * @param   pVM     Pointer to the VM.
    36503650 * @param   pVCpu   The VMCPU to operate on.
    36513651 */
    … …  
    41464146 * @returns VINF_SUCCESS if everything is fine.
    41474147 * @returns VBox error status after asserting on integrity breach.
    4148  * @param   pVM     The VM handle.
     4148 * @param   pVM     Pointer to the VM.
    41494149 */
    41504150VMMR3DECL(int) PGMR3CheckIntegrity(PVM pVM)

  • trunk/src/VBox/VMM/VMMR3/PGMBth.h

    r41458 r41783  
    4040 *
    4141 * @returns VBox status code.
    42  * @param   pVM             The VM handle.
     42 * @param   pVM             Pointer to the VM.
    4343 * @param   fResolveGCAndR0 Indicate whether or not GC and Ring-0 symbols can be resolved now.
    4444 *                          This is used early in the init process to avoid trouble with PDM
    … …  
    199199 *
    200200 * @returns VBox status code.
    201  * @param   pVM         The VM handle.
     201 * @param   pVM         Pointer to the VM.
    202202 * @param   pVCpu       The VMCPU to operate on.
    203203 * @param   offDelta    The relocation offset.

  • trunk/src/VBox/VMM/VMMR3/PGMDbg.cpp

    r41777 r41783  
    4949typedef struct PGMR3DUMPHIERARCHYSTATE
    5050{
    51     /** The VM handle. */
     51    /** Pointer to the VM. */
    5252    PVM             pVM;
    5353    /** Output helpers. */
    … …  
    103103 * @retval  VERR_INVALID_POINTER if the pointer is not within the GC physical memory.
    104104 *
    105  * @param   pVM         The VM handle.
     105 * @param   pVM         Pointer to the VM.
    106106 * @param   R3Ptr       The R3 pointer to convert.
    107107 * @param   pGCPhys     Where to store the GC physical address on success.
    … …  
    125125 * @retval  VERR_INVALID_POINTER if the pointer is not within the GC physical memory.
    126126 *
    127  * @param   pVM         The VM handle.
     127 * @param   pVM         Pointer to the VM.
    128128 * @param   R3Ptr       The R3 pointer to convert.
    129129 * @param   pHCPhys     Where to store the HC physical address on success.
    … …  
    146146 * @retval  VERR_INVALID_POINTER if the HC physical address is not within the GC physical memory.
    147147 *
    148  * @param   pVM     The VM handle.
     148 * @param   pVM     Pointer to the VM.
    149149 * @param   HCPhys  The HC physical address to convert.
    150150 * @param   pGCPhys Where to store the GC physical address on success.
    … …  
    184184 * @returns VBox status code.
    185185 *
    186  * @param   pVM         The VM handle.
     186 * @param   pVM         Pointer to the VM.
    187187 * @param   pvDst       Where to store what's read.
    188188 * @param   GCPhysDst   Where to start reading from.
    … …  
    235235 * @returns VBox status code.
    236236 *
    237  * @param   pVM         The VM handle.
     237 * @param   pVM         Pointer to the VM.
    238238 * @param   GCPhysDst   Where to start writing.
    239239 * @param   pvSrc       What to write.
    … …  
    286286 * @returns VBox status code.
    287287 *
    288  * @param   pVM         The VM handle.
     288 * @param   pVM         Pointer to the VM.
    289289 * @param   pvDst       Where to store what's read.
    290290 * @param   GCPtrDst    Where to start reading from.
    … …  
    342342 * @returns VBox status code.
    343343 *
    344  * @param   pVM         The VM handle.
     344 * @param   pVM         Pointer to the VM.
    345345 * @param   GCPtrDst    Where to start writing.
    346346 * @param   pvSrc       What to write.
    … …  
    849849 *
    850850 * @param   pState          The state to initialize.
    851  * @param   pVM             The VM handle.
     851 * @param   pVM             Pointer to the VM.
    852852 * @param   fFlags          The flags.
    853853 * @param   u64FirstAddr    The first address.
    … …  
    13261326 *
    13271327 * @returns VBox status code (VINF_SUCCESS).
    1328  * @param   pVM         The VM handle.
     1328 * @param   pVM         Pointer to the VM.
    13291329 * @param   HCPhys      The physical address of the table.
    13301330 * @param   cMaxDepth   The maximum depth.
    … …  
    14031403 *
    14041404 * @returns VBox status code (VINF_SUCCESS).
    1405  * @param   pVM         The VM handle.
     1405 * @param   pVM         Pointer to the VM.
    14061406 * @param   pPT         Pointer to the page table.
    14071407 * @param   fMapping    Set if it's a guest mapping.
    … …  
    16301630 *
    16311631 * @returns VBox status code.
    1632  * @param   pVM             The VM handle.
     1632 * @param   pVM             Pointer to the VM.
    16331633 * @param   cr3             The CR3 register value.
    16341634 * @param   fFlags          The flags, DBGFPGDMP_FLAGS_XXX.
    … …  
    16581658 *
    16591659 * @returns VBox status code (VINF_SUCCESS).
    1660  * @param   pVM         The VM handle.
     1660 * @param   pVM         Pointer to the VM.
    16611661 * @param   cr3         The root of the hierarchy.
    16621662 * @param   cr4         The cr4, only PAE and PSE is currently used.
    … …  
    19991999 *
    20002000 * @returns VBox status code (VINF_SUCCESS).
    2001  * @param   pVM         The VM handle.
     2001 * @param   pVM         Pointer to the VM.
    20022002 * @param   GCPhys      The physical address of the table.
    20032003 * @param   cMaxDepth   The maximum depth.
    … …  
    23082308 *
    23092309 * @returns VBox status code.
    2310  * @param   pVM             The VM handle.
     2310 * @param   pVM             Pointer to the VM.
    23112311 * @param   cr3             The CR3 register value.
    23122312 * @param   fFlags          The flags, DBGFPGDMP_FLAGS_XXX.

  • trunk/src/VBox/VMM/VMMR3/PGMGst.h

    r35333 r41783  
    3838 *
    3939 * @returns VBox status code.
    40  * @param   pVM             The VM handle.
     40 * @param   pVM             Pointer to the VM.
    4141 * @param   fResolveGCAndR0 Indicate whether or not GC and Ring-0 symbols can be resolved now.
    4242 *                          This is used early in the init process to avoid trouble with PDM

  • trunk/src/VBox/VMM/VMMR3/PGMMap.cpp

    r41386 r41783  
    4747 *
    4848 * @returns VBox status code.
    49  * @param   pVM             The VM handle.
     49 * @param   pVM             Pointer to the VM.
    5050 * @param   GCPtr           Virtual Address. (Page table aligned!)
    5151 * @param   cb              Size of the range. Must be a 4MB aligned!
    … …  
    215215 *
    216216 * @returns VBox status code.
    217  * @param   pVM     The VM handle.
     217 * @param   pVM     Pointer to the VM.
    218218 * @param   GCPtr   Virtual Address. (Page table aligned!)
    219219 *
    … …  
    289289 *
    290290 * @returns true/false.
    291  * @param   pVM         The VM handle.
     291 * @param   pVM         Pointer to the VM.
    292292 * @param   iPD         The first PDE in the range.
    293293 * @param   cPTs        The number of PDEs in the range.
    … …  
    313313 * The mapping *must* be in the list.
    314314 *
    315  * @param   pVM             The VM handle.
     315 * @param   pVM             Pointer to the VM.
    316316 * @param   pMapping        The mapping to unlink.
    317317 */
    … …  
    345345 * Links the mapping.
    346346 *
    347  * @param   pVM             The VM handle.
     347 * @param   pVM             Pointer to the VM.
    348348 * @param   pMapping        The mapping to linked.
    349349 */
    … …  
    392392 *
    393393 * @returns VBox status code.
    394  * @param   pVM     The VM handle.
     394 * @param   pVM     Pointer to the VM.
    395395 * @thread  EMT(0)
    396396 */
    … …  
    478478 *
    479479 * @returns VBox status code.
    480  * @param   pVM     The VM handle.
     480 * @param   pVM     Pointer to the VM.
    481481 * @param   pcb     Where to store the size.
    482482 */
    … …  
    498498 *
    499499 * @returns VBox status code.
    500  * @param   pVM         The VM handle.
     500 * @param   pVM         Pointer to the VM.
    501501 * @param   GCPtrBase   The address of the reserved range of guest memory.
    502502 * @param   cb          The size of the range starting at GCPtrBase.
    … …  
    538538 *
    539539 * @returns VBox status code.
    540  * @param   pVM         The VM handle.
     540 * @param   pVM         Pointer to the VM.
    541541 * @param   GCPtrBase   The address of the reserved range of guest memory.
    542542 * @param   cb          The size of the range starting at GCPtrBase.
    … …  
    680680 *
    681681 * @returns VBox status code.
    682  * @param   pVM         The VM handle.
     682 * @param   pVM         Pointer to the VM.
    683683 */
    684684VMMR3DECL(int) PGMR3MappingsDisable(PVM pVM)
    … …  
    721721 *
    722722 * @returns VBox status code.
    723  * @param   pVM         The VM handle.
     723 * @param   pVM         Pointer to the VM.
    724724 */
    725725VMMR3DECL(int) PGMR3MappingsUnfix(PVM pVM)
    … …  
    750750 *
    751751 * @returns true if they need, false if not.
    752  * @param   pVM                 The VM handle.
     752 * @param   pVM                 Pointer to the VM.
    753753 */
    754754VMMR3DECL(bool) PGMR3MappingsNeedReFixing(PVM pVM)
    … …  
    766766 *
    767767 * @returns VBox status code.
    768  * @param   pVM         The VM handle.
     768 * @param   pVM         Pointer to the VM.
    769769 * @param   Addr        Intermediate context address of the mapping.
    770770 * @param   HCPhys      Start of the range of physical pages. This must be entriely below 4GB!
    … …  
    831831 *
    832832 * @returns VBox status code.
    833  * @param   pVM             The VM handle.
     833 * @param   pVM             Pointer to the VM.
    834834 * @param   uAddress        Address of the mapping.
    835835 * @param   cPages          Number of pages.
    … …  
    913913 * Sets up the intermediate page tables for a verified mapping.
    914914 *
    915  * @param   pVM             The VM handle.
     915 * @param   pVM             Pointer to the VM.
    916916 * @param   uAddress        Address of the mapping.
    917917 * @param   HCPhys          The physical address of the page range.
    … …  
    970970 * Clears all PDEs involved with the mapping in the shadow and intermediate page tables.
    971971 *
    972  * @param   pVM         The VM handle.
     972 * @param   pVM         Pointer to the VM.
    973973 * @param   pMap        Pointer to the mapping in question.
    974974 * @param   iOldPDE     The index of the 32-bit PDE corresponding to the base of the mapping.
    … …  
    10101010 * Sets all PDEs involved with the mapping in the shadow and intermediate page tables.
    10111011 *
    1012  * @param   pVM         The VM handle.
     1012 * @param   pVM         Pointer to the VM.
    10131013 * @param   pMap        Pointer to the mapping in question.
    10141014 * @param   iNewPDE     The index of the 32-bit PDE corresponding to the base of the mapping.
    … …  
    10641064 * Relocates a mapping to a new address.
    10651065 *
    1066  * @param   pVM                 The VM handle.
     1066 * @param   pVM                 Pointer to the VM.
    10671067 * @param   pMapping            The mapping to relocate.
    10681068 * @param   GCPtrOldMapping     The address of the start of the old mapping.
    … …  
    11861186 *
    11871187 * @returns VBox status code.
    1188  * @param   pVM                 The VM handle.
     1188 * @param   pVM                 Pointer to the VM.
    11891189 * @param   pMapping            The mapping which conflicts.
    11901190 * @param   pPDSrc              The page directory of the guest OS.
    … …  
    12631263 *
    12641264 * @returns VBox status code.
    1265  * @param   pVM                 The VM handle.
     1265 * @param   pVM                 Pointer to the VM.
    12661266 * @param   pMapping            The mapping which conflicts.
    12671267 * @param   GCPtrOldMapping     The address of the start of the current mapping.
    … …  
    13551355 *
    13561356 * @returns VBox status.
    1357  * @param   pVM         The VM handle.
     1357 * @param   pVM         Pointer to the VM.
    13581358 * @param   pvDst       The destination address (HC of course).
    13591359 * @param   GCPtrSrc    The source address (GC virtual address).

  • trunk/src/VBox/VMM/VMMR3/PGMPhys.cpp

    r41521 r41783  
    102102 * @retval  VINF_SUCCESS.
    103103 *
    104  * @param   pVM             The VM handle.
     104 * @param   pVM             Pointer to the VM.
    105105 * @param   GCPhys          Physical address to read from.
    106106 * @param   pvBuf           Where to read into.
    … …  
    231231 * @retval  VERR_EM_NO_MEMORY.
    232232 *
    233  * @param   pVM             The VM handle.
     233 * @param   pVM             Pointer to the VM.
    234234 * @param   GCPhys          Physical address to write to.
    235235 * @param   pvBuf           What to write.
    … …  
    353353 *
    354354 * @returns see PGMR3PhysGCPhys2CCPtrExternal
    355  * @param   pVM         The VM handle.
     355 * @param   pVM         Pointer to the VM.
    356356 * @param   pGCPhys     Pointer to the guest physical address.
    357357 * @param   ppv         Where to store the mapping address.
    … …  
    417417 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS if it's not a valid physical address.
    418418 *
    419  * @param   pVM         The VM handle.
     419 * @param   pVM         Pointer to the VM.
    420420 * @param   GCPhys      The guest physical address of the page that should be mapped.
    421421 * @param   ppv         Where to store the address corresponding to GCPhys.
    … …  
    524524 * @retval  VERR_PGM_INVALID_GC_PHYSICAL_ADDRESS if it's not a valid physical address.
    525525 *
    526  * @param   pVM         The VM handle.
     526 * @param   pVM         Pointer to the VM.
    527527 * @param   GCPhys      The guest physical address of the page that should be mapped.
    528528 * @param   ppv         Where to store the address corresponding to GCPhys.
    … …  
    661661 * Rebuilds the RAM range search trees.
    662662 *
    663  * @param   pVM         The VM handle.
     663 * @param   pVM         Pointer to the VM.
    664664 */
    665665static void pgmR3PhysRebuildRamRangeSearchTrees(PVM pVM)
    … …  
    735735 * Called when anything was relocated.
    736736 *
    737  * @param   pVM         The VM handle.
     737 * @param   pVM         Pointer to the VM.
    738738 */
    739739void pgmR3PhysRelinkRamRanges(PVM pVM)
    … …  
    785785 * Links a new RAM range into the list.
    786786 *
    787  * @param   pVM         The VM handle.
     787 * @param   pVM         Pointer to the VM.
    788788 * @param   pNew        Pointer to the new list entry.
    789789 * @param   pPrev       Pointer to the previous list entry. If NULL, insert as head.
    … …  
    824824 * Unlink an existing RAM range from the list.
    825825 *
    826  * @param   pVM         The VM handle.
     826 * @param   pVM         Pointer to the VM.
    827827 * @param   pRam        Pointer to the new list entry.
    828828 * @param   pPrev       Pointer to the previous list entry. If NULL, insert as head.
    … …  
    860860 * Unlink an existing RAM range from the list.
    861861 *
    862  * @param   pVM         The VM handle.
     862 * @param   pVM         Pointer to the VM.
    863863 * @param   pRam        Pointer to the new list entry.
    864864 */
    … …  
    886886 *
    887887 * @returns VBox status code.
    888  * @param   pVM         The VM handle.
     888 * @param   pVM         Pointer to the VM.
    889889 * @param   pRam        The RAM range in which the pages resides.
    890890 * @param   GCPhys      The address of the first page.
    … …  
    933933 *
    934934 * @returns VINF_SUCCESS (VBox strict status code).
    935  * @param   pVM         The VM handle.
     935 * @param   pVM         Pointer to the VM.
    936936 * @param   pVCpu       The VMCPU for the EMT we're being called on. Unused.
    937937 * @param   pvUser      User parameter
    … …  
    10501050 *
    10511051 * @returns VBox status code.
    1052  * @param   pVM         The VM handle.
     1052 * @param   pVM         Pointer to the VM.
    10531053 * @param   fInflate    Inflate or deflate memory balloon
    10541054 * @param   cPages      Number of pages to free
    … …  
    10751075 *
    10761076 * @returns VBox status code.
    1077  * @param   pVM         The VM handle.
     1077 * @param   pVM         Pointer to the VM.
    10781078 * @param   fInflate    Inflate or deflate memory balloon
    10791079 * @param   cPages      Number of pages to free
    … …  
    11301130 *
    11311131 * @returns VINF_SUCCESS (VBox strict status code).
    1132  * @param   pVM         The VM handle.
     1132 * @param   pVM         Pointer to the VM.
    11331133 * @param   pVCpu       The VMCPU for the EMT we're being called on. Unused.
    11341134 * @param   pvUser      User parameter, unused.
    … …  
    12011201 *
    12021202 * @returns VBox status code.
    1203  * @param   pVM         The VM handle.
     1203 * @param   pVM         Pointer to the VM.
    12041204 */
    12051205VMMR3DECL(int) PGMR3PhysWriteProtectRAM(PVM pVM)
    … …  
    12161216 *
    12171217 * @returns VBox status code.
    1218  * @param   pVM         The VM handle.
     1218 * @param   pVM         Pointer to the VM.
    12191219 * @param   pfnEnum     Enumerate callback handler.
    12201220 * @param   pvUser      Enumerate callback handler parameter.
    … …  
    13001300 *
    13011301 * @returns Number of ram ranges.  Returns UINT32_MAX if @a pVM is invalid.
    1302  * @param   pVM             The VM handle.
     1302 * @param   pVM             Pointer to the VM.
    13031303 */
    13041304VMMR3DECL(uint32_t) PGMR3PhysGetRamRangeCount(PVM pVM)
    … …  
    13581358 *
    13591359 * @returns VBox status code.
    1360  * @param   pVM                 The VM handle.
     1360 * @param   pVM                 Pointer to the VM.
    13611361 * @param   pcbAllocMem         Where to return the amount of memory allocated
    13621362 *                              by VMs.
    … …  
    14011401 *
    14021402 * @returns VBox status code.
    1403  * @param   pVM                 The VM handle.
     1403 * @param   pVM                 Pointer to the VM.
    14041404 * @param   pcbTotalMem         Where to return total amount memory the VM may
    14051405 *                              possibly use.
    … …  
    14471447 * PGMR3PhysRegisterRam worker that initializes and links a RAM range.
    14481448 *
    1449  * @param   pVM             The VM handle.
     1449 * @param   pVM             Pointer to the VM.
    14501450 * @param   pNew            The new RAM range.
    14511451 * @param   GCPhys          The address of the RAM range.
    … …  
    15321532 *
    15331533 * @returns VBox status code.
    1534  * @param   pVM             The VM handle.
     1534 * @param   pVM             Pointer to the VM.
    15351535 * @param   GCPhys          The address of the RAM.
    15361536 * @param   cRamPages       The number of RAM pages to register.
    … …  
    16181618 *
    16191619 * @returns VBox status code.
    1620  * @param   pVM             The VM handle.
     1620 * @param   pVM             Pointer to the VM.
    16211621 * @param   GCPhys          The physical address of the RAM.
    16221622 * @param   cb              The size of the RAM.
    … …  
    17551755 * @returns VBox status code.
    17561756 *
    1757  * @param   pVM     The VM handle.
     1757 * @param   pVM     Pointer to the VM.
    17581758 */
    17591759int pgmR3PhysRamPreAllocate(PVM pVM)
    … …  
    18221822 *
    18231823 * @returns VBox status code.
    1824  * @param   pVM     The VM handle.
     1824 * @param   pVM     Pointer to the VM.
    18251825 */
    18261826int pgmR3PhysRamReset(PVM pVM)
    … …  
    19841984 *
    19851985 * @returns VBox status code.
    1986  * @param   pVM     The VM handle.
     1986 * @param   pVM     Pointer to the VM.
    19871987 */
    19881988int pgmR3PhysRamTerm(PVM pVM)
    … …  
    20652065 * @returns VBox status code.
    20662066 *
    2067  * @param   pVM             The VM handle.
     2067 * @param   pVM             Pointer to the VM.
    20682068 * @param   GCPhys          The start of the MMIO region.
    20692069 * @param   cb              The size of the MMIO region.
    … …  
    22312231 *
    22322232 * @returns VBox status code.
    2233  * @param   pVM             The VM handle.
     2233 * @param   pVM             Pointer to the VM.
    22342234 * @param   GCPhys          The start of the MMIO region.
    22352235 * @param   cb              The size of the MMIO region.
    … …  
    23472347 *
    23482348 * @returns Pointer to the MMIO2 range.
    2349  * @param   pVM             The VM handle.
     2349 * @param   pVM             Pointer to the VM.
    23502350 * @param   pDevIns         The device instance owning the region.
    23512351 * @param   iRegion         The region.
    … …  
    23822382 * @retval  VERR_ALREADY_EXISTS if the region already exists.
    23832383 *
    2384  * @param   pVM             The VM handle.
     2384 * @param   pVM             Pointer to the VM.
    23852385 * @param   pDevIns         The device instance owning the region.
    23862386 * @param   iRegion         The region number.  If the MMIO2 memory is a PCI
    … …  
    25102510 *
    25112511 * @returns VBox status code.
    2512  * @param   pVM             The VM handle.
     2512 * @param   pVM             Pointer to the VM.
    25132513 * @param   pDevIns         The device instance owning the region.
    25142514 * @param   iRegion         The region. If it's UINT32_MAX it'll be a wildcard match.
    … …  
    26152615 * @returns VBox status code.
    26162616 *
    2617  * @param   pVM             The VM handle.
     2617 * @param   pVM             Pointer to the VM.
    26182618 * @param   pDevIns         The device instance owning the region.
    26192619 */
    … …  
    28722872 *
    28732873 * @returns true/false accordingly.
    2874  * @param   pVM             The VM handle.
     2874 * @param   pVM             Pointer to the VM.
    28752875 * @param   pDevIns         The owner of the memory, optional.
    28762876 * @param   GCPhys          The address to check.
    … …  
    29102910 *
    29112911 * @returns VBox status code.
    2912  * @param   pVM             The VM handle.
     2912 * @param   pVM             Pointer to the VM.
    29132913 * @param   pDevIns         The owner of the memory, optional.
    29142914 * @param   iRegion         The region.
    … …  
    29452945 * @return VBox status code.
    29462946 *
    2947  * @param   pVM         The VM handle.
     2947 * @param   pVM         Pointer to the VM.
    29482948 * @param   pDevIns     The device owning the MMIO2 memory.
    29492949 * @param   iRegion     The region.
    … …  
    29872987 *
    29882988 * @returns VBox status.
    2989  * @param   pVM                 The VM handle.
     2989 * @param   pVM                 Pointer to the VM.
    29902990 * @param   pDevIns             The device instance owning the ROM.
    29912991 * @param   GCPhys              First physical address in the range.
    … …  
    33423342 *
    33433343 * @returns VBox status.
    3344  * @param   pVM                 The VM handle.
     3344 * @param   pVM                 Pointer to the VM.
    33453345 * @param   pDevIns             The device instance owning the ROM.
    33463346 * @param   GCPhys              First physical address in the range.
    … …  
    33763376 * @returns VINF_SUCCESS if the handler have carried out the operation.
    33773377 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    3378  * @param   pVM             The VM handle.
     3378 * @param   pVM             Pointer to the VM.
    33793379 * @param   GCPhys          The physical address the guest is writing to.
    33803380 * @param   pvPhys          The HC mapping of that address.
    … …  
    34803480 * ASSUMES that the caller owns the PGM lock.
    34813481 *
    3482  * @param   pVM         The VM handle.
     3482 * @param   pVM         Pointer to the VM.
    34833483 */
    34843484int pgmR3PhysRomReset(PVM pVM)
    … …  
    35803580 * ASSUMES that the caller owns the PGM lock.
    35813581 *
    3582  * @param   pVM         The VM handle.
     3582 * @param   pVM         Pointer to the VM.
    35833583 */
    35843584void pgmR3PhysRomTerm(PVM pVM)
    … …  
    36113611 * @retval  VINF_PGM_SYNC_CR3
    36123612 *
    3613  * @param   pVM         The VM handle.
     3613 * @param   pVM         Pointer to the VM.
    36143614 * @param   GCPhys      Where to start. Page aligned.
    36153615 * @param   cb          How much to change. Page aligned.
    … …  
    37563756typedef struct PGMR3PHYSCHUNKUNMAPCB
    37573757{
    3758     PVM                 pVM;            /**< The VM handle. */
     3758    PVM                 pVM;            /**< Pointer to the VM. */
    37593759    PPGMCHUNKR3MAP      pChunk;         /**< The chunk to unmap. */
    37603760} PGMR3PHYSCHUNKUNMAPCB, *PPGMR3PHYSCHUNKUNMAPCB;
    … …  
    38153815 *
    38163816 * @returns Chunk id.
    3817  * @param   pVM         The VM handle.
     3817 * @param   pVM         Pointer to the VM.
    38183818 */
    38193819static int32_t pgmR3PhysChunkFindUnmapCandidate(PVM pVM)
    … …  
    38503850 *
    38513851 * @returns VINF_SUCCESS (VBox strict status code).
    3852  * @param   pVM         The VM handle.
     3852 * @param   pVM         Pointer to the VM.
    38533853 * @param   pVCpu       The VMCPU for the EMT we're being called on. Unused.
    38543854 * @param   pvUser      User pointer. Unused
    … …  
    39433943 *
    39443944 * @returns VBox status code.
    3945  * @param   pVM         The VM handle.
     3945 * @param   pVM         Pointer to the VM.
    39463946 */
    39473947void pgmR3PhysUnmapChunk(PVM pVM)
    … …  
    39583958 *
    39593959 * @returns VBox status code.
    3960  * @param   pVM         The VM handle.
     3960 * @param   pVM         Pointer to the VM.
    39613961 * @param   idChunk     The chunk in question.
    39623962 * @param   ppChunk     Where to store the chunk tracking structure.
    … …  
    40834083 *
    40844084 * @returns see pgmR3PhysChunkMap.
    4085  * @param   pVM         The VM handle.
     4085 * @param   pVM         Pointer to the VM.
    40864086 * @param   idChunk     The chunk to map.
    40874087 */
    … …  
    41014101 * Invalidates the TLB for the ring-3 mapping cache.
    41024102 *
    4103  * @param   pVM         The VM handle.
     4103 * @param   pVM         Pointer to the VM.
    41044104 */
    41054105VMMR3DECL(void) PGMR3PhysChunkInvalidateTLB(PVM pVM)
    … …  
    41254125 * @retval  VINF_EM_NO_MEMORY if we're out of memory.
    41264126 *
    4127  * @param   pVM         The VM handle.
     4127 * @param   pVM         Pointer to the VM.
    41284128 * @param   GCPhys      GC physical start address of the 2 MB range
    41294129 */
    … …  
    42504250 *          this case and it gets accompanied by VM_FF_PGM_NO_MEMORY.
    42514251 *
    4252  * @param   pVM         The VM handle.
     4252 * @param   pVM         Pointer to the VM.
    42534253 *
    42544254 * @remarks The VINF_EM_NO_MEMORY status is for the benefit of the FF processing
    … …  
    44084408 * This is used by ballooning, remapping MMIO2, RAM reset and state loading.
    44094409 *
    4410  * @param   pVM             The VM handle.
     4410 * @param   pVM             Pointer to the VM.
    44114411 * @param   pReq            Pointer to the request.
    44124412 * @param   pcPendingPages  Where the number of pages waiting to be freed are
    … …  
    45294529 * @retval  VERR_PGM_PHYS_TLB_UNASSIGNED if the page doesn't exist.
    45304530 *
    4531  * @param   pVM         The VM handle.
     4531 * @param   pVM         Pointer to the VM.
    45324532 * @param   GCPhys      The GC physical address to convert.  Since this is only
    45334533 *                      used for filling the REM TLB, the A20 mask must be

  • trunk/src/VBox/VMM/VMMR3/PGMPool.cpp

    r41456 r41783  
    131131 *
    132132 * @returns VBox status code.
    133  * @param   pVM     The VM handle.
     133 * @param   pVM     Pointer to the VM.
    134134 */
    135135int pgmR3PoolInit(PVM pVM)
    … …  
    429429 * Relocate the page pool data.
    430430 *
    431  * @param   pVM     The VM handle.
     431 * @param   pVM     Pointer to the VM.
    432432 */
    433433void pgmR3PoolRelocate(PVM pVM)
    … …  
    454454 *
    455455 * @returns VBox status code.
    456  * @param   pVM     The VM handle.
     456 * @param   pVM     Pointer to the VM.
    457457 */
    458458VMMR3DECL(int) PGMR3PoolGrow(PVM pVM)
    … …  
    638638 *
    639639 * @returns VINF_SUCCESS (VBox strict status code).
    640  * @param   pVM     The VM handle.
     640 * @param   pVM     Pointer to the VM.
    641641 * @param   pVCpu   The VMCPU for the EMT we're being called on. Unused.
    642642 * @param   fpvFlushRemTlb  When not NULL, we'll flush the REM TLB as well.
    … …  
    899899 * Clears the shadow page pool.
    900900 *
    901  * @param   pVM             The VM handle.
     901 * @param   pVM             Pointer to the VM.
    902902 * @param   fFlushRemTlb    When set, the REM TLB is scheduled for flushing as
    903903 *                          well.
    … …  
    913913 * Protect all pgm pool page table entries to monitor writes
    914914 *
    915  * @param   pVM         The VM handle.
     915 * @param   pVM         Pointer to the VM.
    916916 *
    917917 * @remarks ASSUMES the caller will flush all TLBs!!

  • trunk/src/VBox/VMM/VMMR3/PGMSavedState.cpp

    r41774 r41783  
    188188 * @returns Pointer to the ROM page structure. NULL if the caller didn't check
    189189 *          that it's a ROM page.
    190  * @param   pVM         The VM handle.
     190 * @param   pVM         Pointer to the VM.
    191191 * @param   GCPhys      The address of the ROM page.
    192192 */
    … …  
    209209 *
    210210 * @returns VBox status code.
    211  * @param   pVM                 The VM handle.
     211 * @param   pVM                 Pointer to the VM.
    212212 */
    213213static int pgmR3PrepRomPages(PVM pVM)
    … …  
    260260 *
    261261 * @returns VBox status code.
    262  * @param   pVM                 The VM handle.
     262 * @param   pVM                 Pointer to the VM.
    263263 * @param   pSSM                Saved state handle.
    264264 */
    … …  
    290290 * @returns VBox status code.
    291291 *
    292  * @param   pVM                 The VM handle.
     292 * @param   pVM                 Pointer to the VM.
    293293 * @param   pSSM                The saved state handle.
    294294 */
    … …  
    368368 * Scan ROM pages.
    369369 *
    370  * @param   pVM                 The VM handle.
     370 * @param   pVM                 Pointer to the VM.
    371371 */
    372372static void pgmR3ScanRomPages(PVM pVM)
    … …  
    411411 * relinked in any way.
    412412 *
    413  * @param   pVM                 The VM handle.
     413 * @param   pVM                 Pointer to the VM.
    414414 * @param   pSSM                The SSM handle.
    415415 * @param   fLiveSave           Whether we're in a live save or not.
    … …  
    488488 *
    489489 * @returns VBox status code.
    490  * @param   pVM                 The VM handle.
     490 * @param   pVM                 Pointer to the VM.
    491491 * @param   pSSM                The SSM handle.
    492492 * @param   fLiveSave           Whether it's a live save or not.
    … …  
    600600 * Cleans up ROM pages after a live save.
    601601 *
    602  * @param   pVM                 The VM handle.
     602 * @param   pVM                 Pointer to the VM.
    603603 */
    604604static void pgmR3DoneRomPages(PVM pVM)
    … …  
    612612 *
    613613 * @returns VBox status code.
    614  * @param   pVM                 The VM handle.
     614 * @param   pVM                 Pointer to the VM.
    615615 */
    616616static int pgmR3PrepMmio2Pages(PVM pVM)
    … …  
    652652 *
    653653 * @returns VBox status code.
    654  * @param   pVM                 The VM handle.
     654 * @param   pVM                 Pointer to the VM.
    655655 * @param   pSSM                Saved state handle.
    656656 */
    … …  
    681681 * @returns VBox status code.
    682682 *
    683  * @param   pVM                 The VM handle.
     683 * @param   pVM                 Pointer to the VM.
    684684 * @param   pSSM                The saved state handle.
    685685 */
    … …  
    838838 * Scan for MMIO2 page modifications.
    839839 *
    840  * @param   pVM                 The VM handle.
     840 * @param   pVM                 Pointer to the VM.
    841841 * @param   uPass               The pass number.
    842842 */
    … …  
    875875 *
    876876 * @returns VBox status code.
    877  * @param   pVM                 The VM handle.
     877 * @param   pVM                 Pointer to the VM.
    878878 * @param   pSSM                The SSM handle.
    879879 * @param   fLiveSave           Whether it's a live save or not.
    … …  
    10141014 * Cleans up MMIO2 pages after a live save.
    10151015 *
    1016  * @param   pVM                 The VM handle.
     1016 * @param   pVM                 Pointer to the VM.
    10171017 */
    10181018static void pgmR3DoneMmio2Pages(PVM pVM)
    … …  
    10421042 *
    10431043 * @returns VBox status code.
    1044  * @param   pVM                 The VM handle.
     1044 * @param   pVM                 Pointer to the VM.
    10451045 */
    10461046static int pgmR3PrepRamPages(PVM pVM)
    … …  
    11801180 *
    11811181 * @returns VBox status code.
    1182  * @param   pVM                 The VM handle.
     1182 * @param   pVM                 Pointer to the VM.
    11831183 * @param   pSSM                The saved state handle.
    11841184 */
    … …  
    12021202 *
    12031203 * @returns VBox status code.
    1204  * @param   pVM                 The VM handle.
     1204 * @param   pVM                 Pointer to the VM.
    12051205 * @param   pSSM                The saved state handle.
    12061206 */
    … …  
    12351235 * info with it.
    12361236 *
    1237  * @param   pVM                 The VM handle.
     1237 * @param   pVM                 Pointer to the VM.
    12381238 * @param   pCur                The current RAM range.
    12391239 * @param   paLSPages           The current array of live save page tracking
    … …  
    12841284 * Verifies the CRC-32 for a RAM page.
    12851285 *
    1286  * @param   pVM                 The VM handle.
     1286 * @param   pVM                 Pointer to the VM.
    12871287 * @param   pCur                The current RAM range.
    12881288 * @param   paLSPages           The current array of live save page tracking
    … …  
    13111311 * Scan for RAM page modifications and reprotect them.
    13121312 *
    1313  * @param   pVM                 The VM handle.
     1313 * @param   pVM                 Pointer to the VM.
    13141314 * @param   fFinalPass          Whether this is the final pass or not.
    13151315 */
    … …  
    15191519 *
    15201520 * @returns VBox status code.
    1521  * @param   pVM                 The VM handle.
     1521 * @param   pVM                 Pointer to the VM.
    15221522 * @param   pSSM                The SSM handle.
    15231523 * @param   fLiveSave           Whether it's a live save or not.
    … …  
    17391739 * Cleans up RAM pages after a live save.
    17401740 *
    1741  * @param   pVM                 The VM handle.
     1741 * @param   pVM                 Pointer to the VM.
    17421742 */
    17431743static void pgmR3DoneRamPages(PVM pVM)
    … …  
    18081808 * @returns VBox status code.
    18091809 *
    1810  * @param   pVM         The VM handle.
     1810 * @param   pVM         Pointer to the VM.
    18111811 * @param   pSSM        The SSM handle.
    18121812 */
    … …  
    18721872 * @returns VBox status code.
    18731873 *
    1874  * @param   pVM         The VM handle.
     1874 * @param   pVM         Pointer to the VM.
    18751875 * @param   pSSM        The SSM handle.
    18761876 * @param   uPass       The data pass.
    … …  
    19851985 * @returns VBox status code.
    19861986 *
    1987  * @param   pVM         The VM handle.
     1987 * @param   pVM         Pointer to the VM.
    19881988 * @param   pSSM        The SSM handle.
    19891989 */
    … …  
    21762176 *
    21772177 * @returns VBox status code.
    2178  * @param   pVM             The VM handle.
     2178 * @param   pVM             Pointer to the VM.
    21792179 * @param   uType           The page type or PGMPAGETYPE_INVALID (old saved
    21802180 *                          state).
    … …  
    22052205 *
    22062206 * @returns VBox status code.
    2207  * @param   pVM             The VM handle.
     2207 * @param   pVM             Pointer to the VM.
    22082208 * @param   pSSM            The SSM handle.
    22092209 * @param   uType           The page type or PGMPAGETYEP_INVALID (old saved
    … …  
    22492249 *
    22502250 * @returns VBox status code, fully bitched errors.
    2251  * @param   pVM             The VM handle.
     2251 * @param   pVM             Pointer to the VM.
    22522252 * @param   pSSM            The SSM handle.
    22532253 * @param   uType           The page type.
    … …  
    22782278 *
    22792279 * @returns VBox status code, errors are fully bitched.
    2280  * @param   pVM             The VM handle.
     2280 * @param   pVM             Pointer to the VM.
    22812281 * @param   pSSM            The saved state handle.
    22822282 * @param   pPage           The page.
    … …  
    25742574 * @returns VBox status code.
    25752575 *
    2576  * @param   pVM                 The VM handle.
     2576 * @param   pVM                 Pointer to the VM.
    25772577 * @param   pSSM                The SSM handle.
    25782578 * @param   uVersion            The PGM saved state unit version.
    … …  
    29372937 * @returns VBox status code.
    29382938 *
    2939  * @param   pVM                 The VM handle.
     2939 * @param   pVM                 Pointer to the VM.
    29402940 * @param   pSSM                The SSM handle.
    29412941 * @param   uVersion            The saved state version.

  • trunk/src/VBox/VMM/VMMR3/PGMSharedPage.cpp

    r40054 r41783  
    227227 * Shared module check helper (called on the way out).
    228228 *
    229  * @param   pVM         The VM handle.
     229 * @param   pVM         Pointer to the VM.
    230230 * @param   VMCPUID     VCPU id
    231231 */

  • trunk/src/VBox/VMM/VMMR3/PGMShw.h

    r41458 r41783  
    131131 *
    132132 * @returns VBox status code.
    133  * @param   pVM             The VM handle.
     133 * @param   pVM             Pointer to the VM.
    134134 * @param   fResolveGCAndR0 Indicate whether or not GC and Ring-0 symbols can be resolved now.
    135135 *                          This is used early in the init process to avoid trouble with PDM

  • trunk/src/VBox/VMM/VMMR3/SELM.cpp

    r39402 r41783  
    243243 *
    244244 * @returns VBox status code.
    245  * @param   pVM     The VM handle.
     245 * @param   pVM     Pointer to the VM.
    246246 */
    247247VMMR3DECL(int) SELMR3InitFinalize(PVM pVM)
    … …  
    286286 * Setup the hypervisor GDT selectors in our shadow table
    287287 *
    288  * @param   pVM     The VM handle.
     288 * @param   pVM     Pointer to the VM.
    289289 */
    290290static void selmR3SetupHyperGDTSelectors(PVM pVM)
    … …  
    16541654 *
    16551655 * @returns VBox status code.
    1656  * @param   pVM         The VM Handle.
     1656 * @param   pVM         Pointer to the VM.
    16571657 */
    16581658VMMR3DECL(int) SELMR3DebugCheck(PVM pVM)

  • trunk/src/VBox/VMM/VMMR3/SSM.cpp

    r41777 r41783  
    453453    SSMSTRM                 Strm;
    454454
    455     /** The VM handle. */
     455    /** Pointer to the VM. */
    456456    PVM                     pVM;
    457457    /** The current operation. */
    … …  
    896896 * Cleans up resources allocated by SSM on VM termination.
    897897 *
    898  * @param   pVM                 The VM handle.
     898 * @param   pVM                 Pointer to the VM.
    899899 */
    900900VMMR3_INT_DECL(void) SSMR3Term(PVM pVM)
    … …  
    11011101 *
    11021102 * @returns VBox status code.
    1103  * @param   pVM             The VM handle.
     1103 * @param   pVM             Pointer to the VM.
    11041104 * @param   pszName         Data unit name.
    11051105 * @param   uInstance       The instance id.
    … …  
    12071207 * @returns VBox status.
    12081208 *
    1209  * @param   pVM             The VM handle.
     1209 * @param   pVM             Pointer to the VM.
    12101210 * @param   pDevIns         Device instance.
    12111211 * @param   pszName         Data unit name.
    … …  
    12601260 * @returns VBox status.
    12611261 *
    1262  * @param   pVM             The VM handle.
     1262 * @param   pVM             Pointer to the VM.
    12631263 * @param   pDrvIns         Driver instance.
    12641264 * @param   pszName         Data unit name.
    … …  
    13111311 * @returns VBox status.
    13121312 *
    1313  * @param   pVM             The VM handle.
     1313 * @param   pVM             Pointer to the VM.
    13141314 * @param   pszName         Data unit name.
    13151315 * @param   uInstance       The instance identifier of the data unit.
    … …  
    13601360 * @returns VBox status.
    13611361 *
    1362  * @param   pVM             The VM handle.
     1362 * @param   pVM             Pointer to the VM.
    13631363 * @param   pszName         Data unit name.
    13641364 * @param   uInstance       The instance identifier of the data unit.
    … …  
    14111411 * @returns VBox status.
    14121412 *
    1413  * @param   pVM             The VM handle.
     1413 * @param   pVM             Pointer to the VM.
    14141414 * @param   pDevIns         Device instance.
    14151415 * @param   pszName         Data unit name.
    … …  
    14871487 *
    14881488 * @returns VBox status.
    1489  * @param   pVM             The VM handle.
     1489 * @param   pVM             Pointer to the VM.
    14901490 * @param   pDrvIns         Driver instance.
    14911491 * @param   pszName         Data unit name.
    … …  
    15611561 *
    15621562 * @returns VBox status.
    1563  * @param   pVM             The VM handle.
     1563 * @param   pVM             Pointer to the VM.
    15641564 * @param   enmType         Unit type
    15651565 * @param   pszName         Data unit name.
    … …  
    16181618 *
    16191619 * @returns VBox status.
    1620  * @param   pVM             The VM handle.
     1620 * @param   pVM             Pointer to the VM.
    16211621 * @param   pszName         Data unit name.
    16221622 * @remark  Only for dynamic data units.
    … …  
    16321632 *
    16331633 * @returns VBox status.
    1634  * @param   pVM             The VM handle.
     1634 * @param   pVM             Pointer to the VM.
    16351635 * @param   pszName         Data unit name.
    16361636 * @remark  Only for dynamic data units.
    … …  
    29902990 * Makes the SSM operation cancellable or not (via SSMR3Cancel).
    29912991 *
    2992  * @param   pVM             The VM handle.
     2992 * @param   pVM             Pointer to the VM.
    29932993 * @param   pSSM            The saved state handle. (SSMHANDLE::rc may be set.)
    29942994 * @param   fCancellable    The new state.
    … …  
    41354135 * @returns VBox status code.
    41364136 * @param   pSSM                    The saved state handle.
    4137  * @param   lrdPct                  The progress of the the live save.
     4137 * @param   lrdPct                  The progress of the live save.
    41384138 * @param   uPass                   The current pass.
    41394139 */
    … …  
    42234223 *
    42244224 * @returns VBox status code (pSSM->rc).
    4225  * @param   pVM                 The VM handle.
     4225 * @param   pVM                 Pointer to the VM.
    42264226 * @param   pSSM                The saved state handle.
    42274227 */
    … …  
    42794279 *
    42804280 * @returns VBox status code (pSSM->rc).
    4281  * @param   pVM                 The VM handle.
     4281 * @param   pVM                 Pointer to the VM.
    42824282 * @param   pSSM                The saved state handle.
    42834283 */
    … …  
    43784378 *
    43794379 * @returns VBox status code.
    4380  * @param   pVM                 The VM handle.
     4380 * @param   pVM                 Pointer to the VM.
    43814381 * @param   pSSM                The SSM handle.
    43824382 * @param   pcEntries           Where to return the number of directory entries.
    … …  
    44334433 *
    44344434 * @returns VBox status code (pSSM->rc).
    4435  * @param   pVM                 The VM handle.
     4435 * @param   pVM                 Pointer to the VM.
    44364436 * @param   pSSM                The saved state handle.
    44374437 */
    … …  
    45244524 *
    45254525 * @returns VBox status code (pSSM->rc).
    4526  * @param   pVM                 The VM handle.
     4526 * @param   pVM                 Pointer to the VM.
    45274527 * @param   pSSM                The saved state handle.
    45284528 */
    … …  
    46644664 *
    46654665 * @returns VBox status code (pSSM->rc).
    4666  * @param   pVM                 The VM handle.
     4666 * @param   pVM                 Pointer to the VM.
    46674667 * @param   pSSM                The saved state handle.
    46684668 */
    … …  
    47254725 *
    47264726 * @returns VBox status code (no need to check pSSM->rc).
    4727  * @param   pVM                 The VM handle.
     4727 * @param   pVM                 Pointer to the VM.
    47284728 * @param   pSSM                The state handle.
    47294729 *
    … …  
    47924792 *
    47934793 * @returns VBox status code.
    4794  * @param   pVM                 The VM handle.
     4794 * @param   pVM                 Pointer to the VM.
    47954795 * @param   pSSM                The SSM handle.
    47964796 */
    … …  
    48384838 *
    48394839 * @returns VBox status code.
    4840  * @param   pVM                 The VM handle.
     4840 * @param   pVM                 Pointer to the VM.
    48414841 * @param   pszFilename         The name of the file.  NULL if pStreamOps is
    48424842 *                              used.
    … …  
    49034903 * @returns VBox status.
    49044904 *
    4905  * @param   pVM             The VM handle.
     4905 * @param   pVM             Pointer to the VM.
    49064906 * @param   pszFilename     Name of the file to save the state in. NULL if pStreamOps is used.
    49074907 * @param   pStreamOps      The stream method table. NULL if pszFilename is
    … …  
    49974997 * @retval  VINF_SSM_VOTE_FOR_ANOTHER_PASS if we need another pass.
    49984998 *
    4999  * @param   pVM                 The VM handle.
     4999 * @param   pVM                 Pointer to the VM.
    50005000 * @param   pSSM                The saved state handle.
    50015001 * @param   uPass               The current pass.
    … …  
    50985098 * @returns VBox status code (no need to check pSSM->rc).
    50995099 *
    5100  * @param   pVM                 The VM handle.
     5100 * @param   pVM                 Pointer to the VM.
    51015101 * @param   pSSM                The saved state handle.
    51025102 * @param   uPass               The current pass.
    … …  
    52255225 *
    52265226 * @returns VBox status code (no need to check pSSM->rc).
    5227  * @param   pVM                 The VM handle.
     5227 * @param   pVM                 Pointer to the VM.
    52285228 * @param   pSSM                The saved state handle.
    52295229 */
    … …  
    52975297 *
    52985298 * @returns VBox status code (no need to check pSSM->rc).
    5299  * @param   pVM                 The VM handle.
     5299 * @param   pVM                 Pointer to the VM.
    53005300 * @param   pSSM                The saved state handle.
    53015301 */
    … …  
    54035403 * @returns VBox status.
    54045404 *
    5405  * @param   pVM             The VM handle.
     5405 * @param   pVM             Pointer to the VM.
    54065406 * @param   cMsMaxDowntime  The maximum downtime given as milliseconds.
    54075407 * @param   pszFilename     Name of the file to save the state in. This string
    … …  
    76457645 * @returns VBox status code.
    76467646 *
    7647  * @param   pVM                 The VM handle.
     7647 * @param   pVM                 Pointer to the VM.
    76487648 * @param   pszFilename         The filename. NULL if pStreamOps is used.
    76497649 * @param   pStreamOps          The stream method table. NULL if pszFilename is
    … …  
    77987798 *
    77997799 * @returns VBox status code.
    7800  * @param   pVM                 The VM handle.
     7800 * @param   pVM                 Pointer to the VM.
    78017801 * @param   pSSM                The saved state handle.
    78027802 */
    … …  
    80548054 * @returns VBox status code.  May or may not set pSSM->rc, the returned
    80558055 *          status code is ALWAYS the more accurate of the two.
    8056  * @param   pVM                 The VM handle.
     8056 * @param   pVM                 Pointer to the VM.
    80578057 * @param   pSSM                The saved state handle.
    80588058 */
    … …  
    82188218 * @returns VBox status.
    82198219 *
    8220  * @param   pVM             The VM handle.
     8220 * @param   pVM             Pointer to the VM.
    82218221 * @param   pszFilename     The name of the saved state file. NULL if pStreamOps
    82228222 *                          is used.
    … …  
    90969096 *          cancelled.
    90979097 *
    9098  * @param   pVM                 The VM handle.
     9098 * @param   pVM                 Pointer to the VM.
    90999099 *
    91009100 * @thread  Any.

  • trunk/src/VBox/VMM/VMMR3/STAM.cpp

    r40005 r41783  
    101101    /** Pointer to the current buffer position. */
    102102    char           *psz;
    103     /** The VM handle. */
     103    /** Pointer to the VM. */
    104104    PVM             pVM;
    105105    /** The number of bytes allocated. */
    … …  
    366366 *
    367367 * @returns VBox status.
    368  * @param   pVM         The VM handle.
     368 * @param   pVM         Pointer to the VM.
    369369 * @param   pvSample    Pointer to the sample.
    370370 * @param   enmType     Sample type. This indicates what pvSample is pointing at.
    … …  
    412412 *
    413413 * @returns VBox status.
    414  * @param   pVM         The VM handle.
     414 * @param   pVM         Pointer to the VM.
    415415 * @param   pvSample    Pointer to the sample.
    416416 * @param   enmType     Sample type. This indicates what pvSample is pointing at.
    … …  
    437437 *
    438438 * @returns VBox status.
    439  * @param   pVM         The VM handle.
     439 * @param   pVM         Pointer to the VM.
    440440 * @param   pvSample    Pointer to the sample.
    441441 * @param   enmType     Sample type. This indicates what pvSample is pointing at.
    … …  
    467467 *
    468468 * @returns VBox status.
    469  * @param   pVM         The VM handle.
     469 * @param   pVM         Pointer to the VM.
    470470 * @param   pvSample    Pointer to the sample.
    471471 * @param   enmType     Sample type. This indicates what pvSample is pointing at.
    … …  
    488488 *
    489489 * @returns VBox status.
    490  * @param   pVM         The VM handle.
     490 * @param   pVM         Pointer to the VM.
    491491 * @param   pvSample    Pointer to the sample.
    492492 * @param   enmVisibility  Visibility type specifying whether unused statistics should be visible or not.
    … …  
    515515 *
    516516 * @returns VBox status.
    517  * @param   pVM         The VM handle.
     517 * @param   pVM         Pointer to the VM.
    518518 * @param   pvSample    Pointer to the sample.
    519519 * @param   enmVisibility  Visibility type specifying whether unused statistics should be visible or not.
    … …  
    780780 *
    781781 * @returns VBox status.
    782  * @param   pVM         The VM handle.
     782 * @param   pVM         Pointer to the VM.
    783783 * @param   pvSample    Pointer to the sample registered with STAMR3Register().
    784784 */
    … …  
    794794 *
    795795 * @returns VBox status. (Basically, it cannot fail.)
    796  * @param   pVM         The VM handle.
     796 * @param   pVM         Pointer to the VM.
    797797 * @param   pszPat      The name matching pattern. See somewhere_where_this_is_described_in_detail.
    798798 *                      If NULL all samples are reset.
    … …  
    880880 *
    881881 * @returns VBox status. (Basically, it cannot fail.)
    882  * @param   pVM         The VM handle.
     882 * @param   pVM         Pointer to the VM.
    883883 * @param   pszPat      The name matching pattern. See somewhere_where_this_is_described_in_detail.
    884884 *                      If NULL all samples are reset.
    … …  
    897897 * @returns VINF_SUCCESS
    898898 * @param   pDesc   Pointer to the current descriptor.
    899  * @param   pvArg   User argument - The VM handle.
     899 * @param   pvArg   User argument - Pointer to the VM.
    900900 */
    901901static int stamR3ResetOne(PSTAMDESC pDesc, void *pvArg)
    … …  
    10271027 *
    10281028 * @returns VBox status. (Basically, it cannot fail.)
    1029  * @param   pVM             The VM handle.
     1029 * @param   pVM             Pointer to the VM.
    10301030 * @param   pszPat          The name matching pattern. See somewhere_where_this_is_described_in_detail.
    10311031 *                          If NULL all samples are reset.
    … …  
    13001300 *
    13011301 * @returns VBox status.
    1302  * @param   pVM             The VM handle.
     1302 * @param   pVM             Pointer to the VM.
    13031303 * @param   pszSnapshot     The snapshot data pointer returned by STAMR3Snapshot().
    13041304 *                          NULL is allowed.
    … …  
    13341334 *
    13351335 * @returns VBox status.
    1336  * @param   pVM             The VM handle.
     1336 * @param   pVM             Pointer to the VM.
    13371337 * @param   pszPat          The name matching pattern. See somewhere_where_this_is_described_in_detail.
    13381338 *                          If NULL all samples are written to the log.
    … …  
    13851385 *
    13861386 * @returns VBox status.
    1387  * @param   pVM             The VM handle.
     1387 * @param   pVM             Pointer to the VM.
    13881388 * @param   pszPat          The name matching pattern. See somewhere_where_this_is_described_in_detail.
    13891389 *                          If NULL all samples are written to the log.
    … …  
    14161416 *
    14171417 * @returns VBox status.
    1418  * @param   pVM             The VM handle.
     1418 * @param   pVM             Pointer to the VM.
    14191419 * @param   pszPat          The name matching pattern. See somewhere_where_this_is_described_in_detail.
    14201420 *                          If NULL all samples are reset.
    … …  
    14361436 *
    14371437 * @returns VBox status.
    1438  * @param   pVM             The VM handle.
     1438 * @param   pVM             Pointer to the VM.
    14391439 * @param   pszPat          The name matching pattern. See somewhere_where_this_is_described_in_detail.
    14401440 *                          If NULL all samples are reset.
    … …  
    16111611 * @returns Whatever the callback returns.
    16121612 *
    1613  * @param   pVM         The VM handle.
     1613 * @param   pVM         Pointer to the VM.
    16141614 * @param   pszPat      The pattern to match samples.
    16151615 * @param   pfnEnum     The callback function.

  • trunk/src/VBox/VMM/VMMR3/TM.cpp

    r40274 r41783  
    12601260 *
    12611261 * @returns VBox status code.
    1262  * @param   pVM         The VM handle.
     1262 * @param   pVM         Pointer to the VM.
    12631263 * @param   enmClock    The timer clock.
    12641264 * @param   pszDesc     The timer description.
    … …  
    17711771 *
    17721772 * @returns clock time.
    1773  * @param   pVM         The VM handle.
     1773 * @param   pVM         Pointer to the VM.
    17741774 * @param   enmClock    The clock.
    17751775 */
    … …  
    17941794 * @returns true / false.
    17951795 *
    1796  * @param   pVM         The VM handle.
     1796 * @param   pVM         Pointer to the VM.
    17971797 * @param   enmClock    The queue.
    17981798 */
    … …  
    18081808 *
    18091809 * @returns true / false.
    1810  * @param   pVM         The VM handle.
     1810 * @param   pVM         Pointer to the VM.
    18111811 */
    18121812DECLINLINE(bool) tmR3AnyExpiredTimers(PVM pVM)
    … …  
    26092609 *
    26102610 * @returns VBox status code, all errors are asserted.
    2611  * @param   pVM         The VM handle.
     2611 * @param   pVM         Pointer to the VM.
    26122612 * @param   pVCpu       The virtual CPU handle.
    26132613 * @thread  EMT corresponding to the virtual CPU handle.
    … …  
    26522652 *
    26532653 * @returns VBox status code, all errors are asserted.
    2654  * @param   pVM         The VM handle.
     2654 * @param   pVM         Pointer to the VM.
    26552655 * @param   pVCpu       The virtual CPU handle.
    26562656 * @thread  EMT corresponding to the virtual CPU handle.
    … …  
    26962696 *
    26972697 * @returns VBox status code.
    2698  * @param   pVM         The VM handle.
     2698 * @param   pVM         Pointer to the VM.
    26992699 * @param   u32Percent  The new percentage. 100 means normal operation.
    27002700 */
    … …  
    27092709 *
    27102710 * @returns VBox status code.
    2711  * @param   pVM         The VM handle.
     2711 * @param   pVM         Pointer to the VM.
    27122712 * @param   u32Percent  See TMR3SetWarpDrive().
    27132713 * @internal
    … …  
    27592759 * @retval  VERR_INVALID_PARAMETER if idCpu is out of range.
    27602760 *
    2761  * @param   pVM             The VM handle.
     2761 * @param   pVM             Pointer to the VM.
    27622762 * @param   idCpu           The ID of the virtual CPU which times to get.
    27632763 * @param   pcNsTotal       Where to store the total run time (nano seconds) of
    … …  
    28702870 * called.
    28712871 *
    2872  * @param   pVM                 The VM handle.
     2872 * @param   pVM                 Pointer to the VM.
    28732873 * @param   pTimer              The timer.
    28742874 * @param   pvUser              NULL, unused.

  • trunk/src/VBox/VMM/VMMR3/TRPM.cpp

    r41774 r41783  
    586586 * to relocate itself inside the GC.
    587587 *
    588  * @param   pVM         The VM handle.
     588 * @param   pVM         Pointer to the VM.
    589589 * @param   offDelta    Relocation delta relative to old location.
    590590 */
    … …  
    970970 *
    971971 * @returns VBox status code.
    972  * @param   pVM         The VM handle.
     972 * @param   pVM         Pointer to the VM.
    973973 * @param   pVCpu       The VMCPU handle.
    974974 */

  • trunk/src/VBox/VMM/VMMR3/VM.cpp

    r41777 r41783  
    834834 *
    835835 * @returns VBox status code.
    836  * @param   pVM         The VM handle.
     836 * @param   pVM         Pointer to the VM.
    837837 * @param   idCpu       The Virtual CPU ID.
    838838 */
    … …  
    11181118 *
    11191119 * @returns VBox status code.
    1120  * @param   pVM         The VM handle.
     1120 * @param   pVM         Pointer to the VM.
    11211121 * @param   enmWhat     What's completed.
    11221122 */
    … …  
    12101210 *          code, see FNVMMEMTRENDEZVOUS.)
    12111211 *
    1212  * @param   pVM             The VM handle.
     1212 * @param   pVM             Pointer to the VM.
    12131213 * @param   pVCpu           The VMCPU handle of the EMT.
    12141214 * @param   pvUser          Ignored.
    … …  
    12841284 * Does the suspend notifications.
    12851285 *
    1286  * @param  pVM      The VM handle.
     1286 * @param  pVM      Pointer to the VM.
    12871287 * @thread  EMT(0)
    12881288 */
    … …  
    12991299 *          return code, see FNVMMEMTRENDEZVOUS.)
    13001300 *
    1301  * @param   pVM             The VM handle.
     1301 * @param   pVM             Pointer to the VM.
    13021302 * @param   pVCpu           The VMCPU handle of the EMT.
    13031303 * @param   pvUser          Ignored.
    … …  
    13811381 *          return code, see FNVMMEMTRENDEZVOUS.)
    13821382 *
    1383  * @param   pVM             The VM handle.
     1383 * @param   pVM             Pointer to the VM.
    13841384 * @param   pVCpu           The VMCPU handle of the EMT.
    13851385 * @param   pvUser          Ignored.
    … …  
    14631463 *          return code, see FNVMMEMTRENDEZVOUS.)
    14641464 *
    1465  * @param   pVM             The VM handle.
     1465 * @param   pVM             Pointer to the VM.
    14661466 * @param   pVCpu           The VMCPU handle of the EMT.
    14671467 * @param   pvUser          The pfSuspended argument of vmR3SaveTeleport.
    … …  
    15631563 *          status code. (This is a strict return code, see FNVMMEMTRENDEZVOUS.)
    15641564 *
    1565  * @param   pVM             The VM handle.
     1565 * @param   pVM             Pointer to the VM.
    15661566 * @param   pVCpu           The VMCPU handle of the EMT.
    15671567 * @param   pvUser          The pfSuspended argument of vmR3SaveTeleport.
    … …  
    16051605 * @retval  VINF_SSM_LIVE_SUSPENDED if VMR3Suspend was called.
    16061606 *
    1607  * @param   pVM             The VM handle.
     1607 * @param   pVM             Pointer to the VM.
    16081608 * @param   pSSM            The handle of saved state operation.
    16091609 *
    … …  
    16551655 * @returns VBox status code.
    16561656 *
    1657  * @param   pVM                 The VM handle.
     1657 * @param   pVM                 Pointer to the VM.
    16581658 * @param   cMsMaxDowntime      The maximum downtime given as milliseconds.
    16591659 * @param   pszFilename         The name of the file.  NULL if pStreamOps is used.
    … …  
    17311731 * @returns VBox status code.
    17321732 *
    1733  * @param   pVM                 The VM handle.
     1733 * @param   pVM                 Pointer to the VM.
    17341734 * @param   cMsMaxDowntime      The maximum downtime given as milliseconds.
    17351735 * @param   pszFilename         The name of the file.  NULL if pStreamOps is used.
    … …  
    19631963 * @returns VBox status code.
    19641964 *
    1965  * @param   pVM                 The VM handle.
     1965 * @param   pVM                 Pointer to the VM.
    19661966 * @param   pszFilename         The name of the file.  NULL if pStreamOps is used.
    19671967 * @param   pStreamOps          The stream methods.  NULL if pszFilename is used.
    … …  
    20412041 * @returns VBox status code.
    20422042 *
    2043  * @param   pVM             The VM handle.
     2043 * @param   pVM             Pointer to the VM.
    20442044 * @param   pszFilename     The name of the save state file.
    20452045 * @param   pfnProgress     Progress callback. Optional.
    … …  
    20782078 * @returns VBox status code.
    20792079 *
    2080  * @param   pVM             The VM handle.
     2080 * @param   pVM             Pointer to the VM.
    20812081 * @param   pStreamOps      The stream methods.
    20822082 * @param   pvStreamOpsUser The user argument to the stream methods.
    … …  
    21172117 * @returns VBox status code.
    21182118 *
    2119  * @param   pVM             The VM handle.
     2119 * @param   pVM             Pointer to the VM.
    21202120 * @param   pStreamOps      The stream methods.
    21212121 * @param   pvStreamOpsUser The user argument to the stream methods.
    … …  
    21552155 *          return code, see FNVMMEMTRENDEZVOUS.)
    21562156 *
    2157  * @param   pVM             The VM handle.
     2157 * @param   pVM             Pointer to the VM.
    21582158 * @param   pVCpu           The VMCPU handle of the EMT.
    21592159 * @param   pvUser          Ignored.
    … …  
    23922392 *
    23932393 * @returns VINF_EM_TERMINATE.
    2394  * @param   pVM     The VM handle.
     2394 * @param   pVM     Pointer to the VM.
    23952395 */
    23962396DECLCALLBACK(int) vmR3Destroy(PVM pVM)
    … …  
    27852785 *          is a strict return code, see FNVMMEMTRENDEZVOUS.)
    27862786 *
    2787  * @param   pVM             The VM handle.
     2787 * @param   pVM             Pointer to the VM.
    27882788 * @param   pVCpu           The VMCPU handle of the EMT.
    27892789 * @param   pvUser          Ignored.
    … …  
    29342934
    29352935/**
    2936  * Gets the user mode VM structure pointer given the VM handle.
     2936 * Gets the user mode VM structure pointer given Pointer to the VM.
    29372937 *
    29382938 * @returns Pointer to the user mode VM structure on success. NULL if @a pVM is
    29392939 *          invalid (asserted).
    2940  * @param   pVM                 The VM handle.
     2940 * @param   pVM                 Pointer to the VM.
    29412941 * @sa      VMR3GetVM, VMR3RetainUVM
    29422942 */
    … …  
    33403340 * The caller owns the AtStateCritSect.
    33413341 *
    3342  * @param   pVM                 The VM handle.
     3342 * @param   pVM                 Pointer to the VM.
    33433343 * @param   pUVM                The UVM handle.
    33443344 * @param   enmStateNew         The New state.
    … …  
    33693369 * Sets the current VM state, with the AtStatCritSect already entered.
    33703370 *
    3371  * @param   pVM                 The VM handle.
     3371 * @param   pVM                 Pointer to the VM.
    33723372 * @param   pUVM                The UVM handle.
    33733373 * @param   enmStateNew         The new state.
    … …  
    34143414 *          VERR_VM_INVALID_VM_STATE and Assert+LogRel on failure.
    34153415 *
    3416  * @param   pVM                 The VM handle.
     3416 * @param   pVM                 Pointer to the VM.
    34173417 * @param   pszWho              Who is trying to change it.
    34183418 * @param   cTransitions        The number of transitions in the ellipsis.
    … …  
    35333533 * Called by vmR3EmulationThreadWithId just before the VM structure is freed.
    35343534 *
    3535  * @param   pVM             The VM handle.
     3535 * @param   pVM             Pointer to the VM.
    35363536 */
    35373537void vmR3SetTerminated(PVM pVM)
    … …  
    35483548 *
    35493549 * @returns true / false.
    3550  * @param   pVM                 The VM handle.
     3550 * @param   pVM                 Pointer to the VM.
    35513551 * @thread  Any thread.
    35523552 */
    … …  
    36773677 *
    36783678 * @returns VBox status code.
    3679  * @param   pVM             The VM handle.
     3679 * @param   pVM             Pointer to the VM.
    36803680 * @param   pfnAtError      Pointer to callback.
    36813681 * @param   pvUser          User argument.
    … …  
    36933693 *
    36943694 * @returns VBox status code.
    3695  * @param   pUVM            The VM handle.
     3695 * @param   pUVM            Pointer to the VM.
    36963696 * @param   pfnAtError      Pointer to callback.
    36973697 * @param   pvUser          User argument.
    … …  
    37343734 *
    37353735 * @returns VBox status code.
    3736  * @param   pVM             The VM handle.
     3736 * @param   pVM             Pointer to the VM.
    37373737 * @param   pfnAtError      Pointer to callback.
    37383738 * @param   pvUser          User argument.
    … …  
    38163816 * The message is found in VMINT.
    38173817 *
    3818  * @param   pVM             The VM handle.
     3818 * @param   pVM             Pointer to the VM.
    38193819 * @thread  EMT.
    38203820 */
    … …  
    38673867 *
    38683868 * @returns The error count.
    3869  * @param   pVM             The VM handle.
     3869 * @param   pVM             Pointer to the VM.
    38703870 */
    38713871VMMR3DECL(uint32_t) VMR3GetErrorCount(PVM pVM)
    … …  
    38823882 *
    38833883 * @returns The error count.
    3884  * @param   pVM             The VM handle.
     3884 * @param   pVM             Pointer to the VM.
    38853885 */
    38863886VMMR3DECL(uint32_t) VMR3GetErrorCountU(PUVM pUVM)
    … …  
    39733973 *
    39743974 * @returns VBox status code.
    3975  * @param   pVM                 The VM handle.
     3975 * @param   pVM                 Pointer to the VM.
    39763976 * @param   pfnAtRuntimeError   Pointer to callback.
    39773977 * @param   pvUser              User argument.
    … …  
    40154015 *
    40164016 * @returns VBox status code.
    4017  * @param   pVM                 The VM handle.
     4017 * @param   pVM                 Pointer to the VM.
    40184018 * @param   pfnAtRuntimeError   Pointer to callback.
    40194019 * @param   pvUser              User argument.
    … …  
    40884088 *          return code, see FNVMMEMTRENDEZVOUS.)
    40894089 *
    4090  * @param   pVM             The VM handle.
     4090 * @param   pVM             Pointer to the VM.
    40914091 * @param   pVCpu           The VMCPU handle of the EMT.
    40924092 * @param   pvUser          Ignored.
    … …  
    41254125 * @returns VBox status code with modifications, see VMSetRuntimeErrorV.
    41264126 *
    4127  * @param   pVM             The VM handle.
     4127 * @param   pVM             Pointer to the VM.
    41284128 * @param   fFlags          The error flags.
    41294129 * @param   pszErrorId      Error ID string.
    … …  
    41864186 *
    41874187 * @returns VBox status code, see VMSetRuntimeError.
    4188  * @param   pVM             The VM handle.
     4188 * @param   pVM             Pointer to the VM.
    41894189 * @thread  EMT.
    41904190 */
    … …  
    42234223 * @returns VBox status code with modifications, see VMSetRuntimeErrorV.
    42244224 *
    4225  * @param   pVM             The VM handle.
     4225 * @param   pVM             Pointer to the VM.
    42264226 * @param   fFlags          The error flags.
    42274227 * @param   pszErrorId      Error ID string.
    … …  
    42564256 * @returns VBox status code with modifications, see VMSetRuntimeErrorV.
    42574257 *
    4258  * @param   pVM             The VM handle.
     4258 * @param   pVM             Pointer to the VM.
    42594259 * @param   fFlags          The error flags.
    42604260 * @param   pszErrorId      Error ID string.
    … …  
    42874287 *
    42884288 * @returns The runtime error count.
    4289  * @param   pVM             The VM handle.
     4289 * @param   pVM             Pointer to the VM.
    42904290 */
    42914291VMMR3DECL(uint32_t) VMR3GetRuntimeErrorCount(PVM pVM)
    … …  
    43004300 * @returns The CPU ID. NIL_VMCPUID if the thread isn't an EMT.
    43014301 *
    4302  * @param   pVM             The VM handle.
     4302 * @param   pVM             Pointer to the VM.
    43034303 */
    43044304VMMR3DECL(RTCPUID) VMR3GetVMCPUId(PVM pVM)
    … …  
    43154315 *
    43164316 * @returns Handle if this is an EMT thread; NIL_RTNATIVETHREAD otherwise
    4317  * @param   pVM             The VM handle.
     4317 * @param   pVM             Pointer to the VM.
    43184318 * @thread  EMT
    43194319 */
    … …  
    43334333 *
    43344334 * @returns Handle if this is an EMT thread; NIL_RTNATIVETHREAD otherwise
    4335  * @param   pVM             The VM handle.
     4335 * @param   pVM             Pointer to the VM.
    43364336 * @thread  EMT
    43374337 */
    … …  
    43514351 *
    43524352 * @returns Handle if this is an EMT thread; NIL_RTNATIVETHREAD otherwise
    4353  * @param   pVM             The VM handle.
     4353 * @param   pVM             Pointer to the VM.
    43544354 * @thread  EMT
    43554355 */
    … …  
    43694369 *
    43704370 * @returns Handle if this is an EMT thread; NIL_RTNATIVETHREAD otherwise
    4371  * @param   pVM             The VM handle.
     4371 * @param   pVM             Pointer to the VM.
    43724372 * @thread  EMT
    43734373 */
    … …  
    44234423 *
    44244424 * @returns VINF_EM_WAIT_SPIP (strict status code).
    4425  * @param   pVM                 The VM handle.
     4425 * @param   pVM                 Pointer to the VM.
    44264426 * @param   idCpu               The current CPU.
    44274427 */

  • trunk/src/VBox/VMM/VMMR3/VMEmt.cpp

    r40274 r41783  
    405405 *
    406406 * @return VBox status code. Failure on invalid CFGM data.
    407  * @param   pVM     The VM handle.
     407 * @param   pVM     Pointer to the VM.
    408408 */
    409409static int vmR3HaltMethod12ReadConfigU(PUVM pUVM)

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

    r41777 r41783  
    616616 *
    617617 * @returns VBox status code.
    618  * @param   pVM                 The VM handle.
     618 * @param   pVM                 Pointer to the VM.
    619619 * @param   enmWhat             Which init phase.
    620620 */
    … …  
    700700 *
    701701 * @returns VINF_SUCCESS.
    702  * @param   pVM         The VM handle.
     702 * @param   pVM         Pointer to the VM.
    703703 */
    704704VMMR3_INT_DECL(int) VMMR3Term(PVM pVM)
    … …  
    783783 * The VMM will need to apply relocations to the core code.
    784784 *
    785  * @param   pVM         The VM handle.
     785 * @param   pVM         Pointer to the VM.
    786786 * @param   offDelta    The relocation delta.
    787787 */
    … …  
    835835 *
    836836 * @returns VBox status code.
    837  * @param   pVM     The VM handle.
     837 * @param   pVM     Pointer to the VM.
    838838 */
    839839VMMR3_INT_DECL(int) VMMR3UpdateLoggers(PVM pVM)
    … …  
    934934 *
    935935 * @returns Pointer to the buffer.
    936  * @param   pVM         The VM handle.
     936 * @param   pVM         Pointer to the VM.
    937937 */
    938938VMMR3DECL(const char *) VMMR3GetRZAssertMsg1(PVM pVM)
    … …  
    954954 *
    955955 * @returns Pointer to the buffer.
    956  * @param   pVM         The VM handle.
     956 * @param   pVM         Pointer to the VM.
    957957 */
    958958VMMR3DECL(const char *) VMMR3GetRZAssertMsg2(PVM pVM)
    … …  
    11031103 * Suspends the CPU yielder.
    11041104 *
    1105  * @param   pVM             The VM handle.
     1105 * @param   pVM             Pointer to the VM.
    11061106 */
    11071107VMMR3_INT_DECL(void) VMMR3YieldSuspend(PVM pVM)
    … …  
    11251125 * Stops the CPU yielder.
    11261126 *
    1127  * @param   pVM             The VM handle.
     1127 * @param   pVM             Pointer to the VM.
    11281128 */
    11291129VMMR3_INT_DECL(void) VMMR3YieldStop(PVM pVM)
    … …  
    11391139 * Resumes the CPU yielder when it has been a suspended or stopped.
    11401140 *
    1141  * @param   pVM             The VM handle.
     1141 * @param   pVM             Pointer to the VM.
    11421142 */
    11431143VMMR3_INT_DECL(void) VMMR3YieldResume(PVM pVM)
    … …  
    14271427 *          will be returned here, those are for the caller only.
    14281428 *
    1429  * @param   pVM                 The VM handle.
     1429 * @param   pVM                 Pointer to the VM.
    14301430 */
    14311431DECL_FORCE_INLINE(int) vmmR3EmtRendezvousNonCallerReturn(PVM pVM)
    … …  
    14541454 *          fIsCaller is set, VINF_SUCCESS is always returned.
    14551455 *
    1456  * @param   pVM                 The VM handle.
     1456 * @param   pVM                 Pointer to the VM.
    14571457 * @param   pVCpu               The VMCPU structure for the calling EMT.
    14581458 * @param   fIsCaller           Whether we're the VMMR3EmtRendezvous caller or
    … …  
    16481648 * by one fashion or all at once.
    16491649 *
    1650  * @returns VBox strict status code.  This will be the the first error,
     1650 * @returns VBox strict status code.  This will be the first error,
    16511651 *          VINF_SUCCESS, or an EM scheduling status code.
    16521652 *
    1653  * @param   pVM             The VM handle.
     1653 * @param   pVM             Pointer to the VM.
    16541654 * @param   fFlags          Flags indicating execution methods. See
    16551655 *                          grp_VMMR3EmtRendezvous_fFlags.
    … …  
    18381838 * Calls a RC function.
    18391839 *
    1840  * @param   pVM         The VM handle.
     1840 * @param   pVM         Pointer to the VM.
    18411841 * @param   RCPtrEntry  The address of the RC function.
    18421842 * @param   cArgs       The number of arguments in the ....
    … …  
    18561856 * Calls a RC function.
    18571857 *
    1858  * @param   pVM         The VM handle.
     1858 * @param   pVM         Pointer to the VM.
    18591859 * @param   RCPtrEntry  The address of the RC function.
    18601860 * @param   cArgs       The number of arguments in the ....
    … …  
    22092209 * Displays the Force action Flags.
    22102210 *
    2211  * @param   pVM         The VM handle.
     2211 * @param   pVM         Pointer to the VM.
    22122212 * @param   pHlp        The output helpers.
    22132213 * @param   pszArgs     The additional arguments (ignored).

  • trunk/src/VBox/VMM/VMMR3/VMMSwitcher.cpp

    r41777 r41783  
    275275 * Generic switcher code relocator.
    276276 *
    277  * @param   pVM         The VM handle.
     277 * @param   pVM         Pointer to the VM.
    278278 * @param   pSwitcher   The switcher definition.
    279279 * @param   pu8CodeR3   Pointer to the core code block for the switcher, ring-3 mapping.

  • trunk/src/VBox/VMM/VMMR3/VMMTests.cpp

    r37955 r41783  
    4848 *
    4949 * @returns return value from the test.
    50  * @param   pVM         The VM handle.
     50 * @param   pVM         Pointer to the VM.
    5151 * @param   enmTestcase The testcase operation to perform.
    5252 * @param   uVariation  The testcase variation id.
    … …  
    8282 *
    8383 * @returns Return value from the trap test.
    84  * @param   pVM         The VM handle.
     84 * @param   pVM         Pointer to the VM.
    8585 * @param   u8Trap      The trap number to test.
    8686 * @param   uVariation  The testcase variation.

  • trunk/src/VBox/VMM/VMMR3/VMReq.cpp

    r41777 r41783  
    5656 * @returns VERR_TIMEOUT if cMillies was reached without the packet being completed.
    5757 *
    58  * @param   pVM             The VM handle.
     58 * @param   pVM             Pointer to the VM.
    5959 * @param   idDstCpu        The destination CPU(s). Either a specific CPU ID or
    6060 *                          one of the following special values:
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