VirtualBox

Changeset 41800 in vbox


Ignore:
Timestamp:
Jun 17, 2012 4:18:26 PM (12 years ago)
Author:
vboxsync
Message:

Doxygen.

Location:
trunk/src/VBox/VMM
Files:
76 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/VBox/VMM/VMMAll/CPUMAllRegs.cpp

    r41783 r41800  
    23702370 *
    23712371 * @returns boolean
    2372  * @param   pVM         VM handle.
     2372 * @param   pVM         Pointer to the VM.
    23732373 */
    23742374VMMDECL(bool) CPUMIsGuestDebugStateActive(PVMCPU pVCpu)
    … …  
    23812381 *
    23822382 * @returns boolean
    2383  * @param   pVM         VM handle.
     2383 * @param   pVM         Pointer to the VM.
    23842384 */
    23852385VMMDECL(bool) CPUMIsHyperDebugStateActive(PVMCPU pVCpu)
    … …  
    23932393 *
    23942394 * @returns boolean
    2395  * @param   pVM         VM handle.
     2395 * @param   pVM         Pointer to the VM.
    23962396 */
    23972397VMMDECL(void) CPUMDeactivateGuestDebugState(PVMCPU pVCpu)
    … …  
    24052405 *
    24062406 * @returns boolean
    2407  * @param   pVM         VM handle.
     2407 * @param   pVM         Pointer to the VM.
    24082408 */
    24092409VMMDECL(void) CPUMDeactivateHyperDebugState(PVMCPU pVCpu)
    … …  
    24332433 *
    24342434 * @returns cpl
    2435  * @param   pVM         VM Handle.
     2435 * @param   pVM         Pointer to the VM.
    24362436 * @param   pRegFrame   Trap register frame.
    24372437 */

  • trunk/src/VBox/VMM/VMMAll/EMAll.cpp

    r41799 r41800  
    203203 * Locks REM execution to a single VCpu
    204204 *
    205  * @param   pVM         VM handle.
     205 * @param   pVM         Pointer to the VM.
    206206 */
    207207VMMDECL(void) EMRemLock(PVM pVM)
    … …  
    222222 * Unlocks REM execution
    223223 *
    224  * @param   pVM         VM handle.
     224 * @param   pVM         Pointer to the VM.
    225225 */
    226226VMMDECL(void) EMRemUnlock(PVM pVM)

  • trunk/src/VBox/VMM/VMMAll/IOMAll.cpp

    r41783 r41800  
    215215 * @retval  VINF_IOM_R3_IOPORT_READ     Defer the read to ring-3. (R0/GC only)
    216216 *
    217  * @param   pVM         VM handle.
     217 * @param   pVM         Pointer to the VM.
    218218 * @param   Port        The port to read.
    219219 * @param   pu32Value   Where to store the value read.
    … …  
    388388 * @retval  VINF_IOM_R3_IOPORT_READ     Defer the read to ring-3. (R0/GC only)
    389389 *
    390  * @param   pVM         VM handle.
     390 * @param   pVM         Pointer to the VM.
    391391 * @param   Port        The port to read.
    392392 * @param   pGCPtrDst   Pointer to the destination buffer (GC, incremented appropriately).
    … …  
    540540 * @retval  VINF_IOM_R3_IOPORT_WRITE    Defer the write to ring-3. (R0/GC only)
    541541 *
    542  * @param   pVM         VM handle.
     542 * @param   pVM         Pointer to the VM.
    543543 * @param   Port        The port to write to.
    544544 * @param   u32Value    The value to write.
    … …  
    688688 * @retval  VINF_IOM_R3_IOPORT_WRITE    Defer the write to ring-3. (R0/GC only)
    689689 *
    690  * @param   pVM         VM handle.
     690 * @param   pVM         Pointer to the VM.
    691691 * @param   Port        The port to write.
    692692 * @param   pGCPtrSrc   Pointer to the source buffer (GC, incremented appropriately).
    … …  
    841841 * @retval  VINF_EM_RESCHEDULE_REM      The exception was dispatched and cannot be executed in raw-mode. (TRPMRaiseXcptErr)
    842842 *
    843  * @param   pVM         VM handle.
     843 * @param   pVM         Pointer to the VM.
    844844 * @param   pCtxCore    Pointer to register frame.
    845845 * @param   Port        The I/O port number.

  • trunk/src/VBox/VMM/VMMAll/IOMAllMMIO.cpp

    r41783 r41800  
    14301430 *
    14311431 * @returns VBox status code (appropriate for GC return).
    1432  * @param   pVM         VM Handle.
     1432 * @param   pVM         Pointer to the VM.
    14331433 * @param   uErrorCode  CPU Error code.  This is UINT32_MAX when we don't have
    14341434 *                      any error code (the EPT misconfig hack).
    … …  
    16671667 *
    16681668 * @returns VBox status code (appropriate for GC return).
    1669  * @param   pVM         VM Handle.
     1669 * @param   pVM         Pointer to the VM.
    16701670 * @param   uErrorCode  CPU Error code.
    16711671 * @param   pCtxCore    Trap register frame.
    … …  
    16861686 *
    16871687 * @returns VBox status code (appropriate for GC return).
    1688  * @param   pVM         VM Handle.
     1688 * @param   pVM         Pointer to the VM.
    16891689 * @param   uErrorCode  CPU Error code.
    16901690 * @param   pCtxCore    Trap register frame.
    … …  
    17101710 * @returns VINF_SUCCESS if the handler have carried out the operation.
    17111711 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    1712  * @param   pVM             VM Handle.
     1712 * @param   pVM             Pointer to the VM.
    17131713 * @param   GCPhys          The physical address the guest is writing to.
    17141714 * @param   pvPhys          The HC mapping of that address.
    … …  
    17691769 * @returns VBox status code.
    17701770 *
    1771  * @param   pVM         VM handle.
     1771 * @param   pVM         Pointer to the VM.
    17721772 * @param   GCPhys      The physical address to read.
    17731773 * @param   pu32Value   Where to store the value read.
    … …  
    18981898 * @returns VBox status code.
    18991899 *
    1900  * @param   pVM         VM handle.
     1900 * @param   pVM         Pointer to the VM.
    19011901 * @param   GCPhys      The physical address to write to.
    19021902 * @param   u32Value    The value to write.

  • trunk/src/VBox/VMM/VMMAll/MMAllHyper.cpp

    r41783 r41800  
    12051205/**
    12061206 * Dumps the hypervisor heap to Log.
    1207  * @param pVM       VM Handle.
     1207 * @param pVM       Pointer to the VM.
    12081208 */
    12091209VMMDECL(void) MMHyperHeapDump(PVM pVM)
    … …  
    12511251 *
    12521252 * @returns Base address of the hypervisor area.
    1253  * @param   pVM         VM Handle.
     1253 * @param   pVM         Pointer to the VM.
    12541254 * @param   pcb         Where to store the size of the hypervisor area. (out)
    12551255 */
    … …  
    12671267 * @returns true if inside.
    12681268 * @returns false if outside.
    1269  * @param   pVM         VM handle.
     1269 * @param   pVM         Pointer to the VM.
    12701270 * @param   GCPtr       The pointer to check.
    12711271 */

  • trunk/src/VBox/VMM/VMMAll/MMAllPagePool.cpp

    r35346 r41800  
    8181 *
    8282 * @returns VBox status code.
    83  * @param   pVM         VM handle.
     83 * @param   pVM         Pointer to the VM.
    8484 * @param   HCPhysPage  The physical address of a page.
    8585 * @param   ppvPage     Where to store the address corresponding to HCPhysPage.
    … …  
    112112 *
    113113 * @returns Pointer to the page at that physical address.
    114  * @param   pVM         VM handle.
     114 * @param   pVM         Pointer to the VM.
    115115 * @param   HCPhysPage  The physical address of a page.
    116116 * @thread  The Emulation Thread.
    … …  
    138138 *
    139139 * @returns VBox status code.
    140  * @param   pVM         VM handle.
     140 * @param   pVM         Pointer to the VM.
    141141 * @param   HCPhysPage  The physical address of a page.
    142142 * @param   ppvPage     Where to store the address corresponding to HCPhysPage.
    … …  
    203203 *
    204204 * @returns Physical address for the specified page table.
    205  * @param   pVM         VM handle.
     205 * @param   pVM         Pointer to the VM.
    206206 * @param   pvPage      Page which physical address we query.
    207207 * @thread  The Emulation Thread.

  • trunk/src/VBox/VMM/VMMAll/PATMAll.cpp

    r41783 r41800  
    4343 * IF and IOPL eflags bits, the caller will enforce those to set and 0 respectively.
    4444 *
    45  * @param   pVM         VM handle.
     45 * @param   pVM         Pointer to the VM.
    4646 * @param   pCtxCore    The cpu context core.
    4747 * @see     pg_raw
    … …  
    113113 ** @note Only here we are allowed to switch back to guest code (without a special reason such as a trap in patch code)!!
    114114 *
    115  * @param   pVM         VM handle.
     115 * @param   pVM         Pointer to the VM.
    116116 * @param   pCtxCore    The cpu context core.
    117117 * @param   rawRC       Raw mode return code
    … …  
    237237 * Check if we must use raw mode (patch code being executed)
    238238 *
    239  * @param   pVM         VM handle.
     239 * @param   pVM         Pointer to the VM.
    240240 * @param   pAddrGC     Guest context address
    241241 */

  • trunk/src/VBox/VMM/VMMAll/PDMAll.cpp

    r41783 r41800  
    100100 *
    101101 * @returns VBox status code.
    102  * @param   pVM             VM handle.
     102 * @param   pVM             Pointer to the VM.
    103103 * @param   u8Irq           The IRQ line.
    104104 * @param   u8Level         The new level.
    … …  
    157157 *
    158158 * @returns VBox status code.
    159  * @param   pVM             VM handle.
     159 * @param   pVM             Pointer to the VM.
    160160 * @param   u8Irq           The IRQ line.
    161161 * @param   u8Level         The new level.
    … …  
    179179 *
    180180 * @returns VBox status code.
    181  * @param   pVM             VM handle.
     181 * @param   pVM             Pointer to the VM.
    182182 * @param   GCAddr          Request address.
    183183 * @param   u8Value         Request value.
    … …  
    203203 *
    204204 * @returns VBox true if IO-APIC is present
    205  * @param   pVM             VM handle.
     205 * @param   pVM             Pointer to the VM.
    206206 */
    207207VMMDECL(bool) PDMHasIoApic(PVM pVM)
    … …  
    215215 *
    216216 * @returns VBox status code.
    217  * @param   pVM             VM handle.
     217 * @param   pVM             Pointer to the VM.
    218218 * @param   u64Base         The new base.
    219219 */
    … …  
    236236 *
    237237 * @returns VBox status code.
    238  * @param   pVM             VM handle.
     238 * @param   pVM             Pointer to the VM.
    239239 * @param   pu64Base        Where to store the APIC base.
    240240 */
    … …  
    328328 *
    329329 * @returns VBox status code.
    330  * @param   pVM             VM handle.
     330 * @param   pVM             Pointer to the VM.
    331331 * @param   iCpu            Target CPU.
    332332 * @param   u32Reg          MSR to write.
    … …  
    348348 *
    349349 * @returns VBox status code.
    350  * @param   pVM             VM handle.
     350 * @param   pVM             Pointer to the VM.
    351351 * @param   iCpu            Target CPU.
    352352 * @param   u32Reg          MSR to read.
    … …  
    413413 *
    414414 * @returns VBox status code.
    415  * @param   pVM             VM handle.
     415 * @param   pVM             Pointer to the VM.
    416416 * @param   pv              Ring-3 pointer.
    417417 * @param   pGCPhys         GC phys address (out).
    … …  
    435435 *
    436436 * @returns dev heap enabled status (true/false)
    437  * @param   pVM             VM handle.
     437 * @param   pVM             Pointer to the VM.
    438438 */
    439439VMMDECL(bool)   PDMVMMDevHeapIsEnabled(PVM pVM)

  • trunk/src/VBox/VMM/VMMAll/PGMAllGst.h

    r41391 r41800  
    614614 * @returns true if bits were flushed.
    615615 * @returns false if bits weren't flushed.
    616  * @param   pVM     VM handle.
     616 * @param   pVM     Pointer to the VM.
    617617 * @param   pPDSrc  The page directory.
    618618 * @param   cr4     The cr4 register value.

  • trunk/src/VBox/VMM/VMMAll/PGMAllHandler.cpp

    r41783 r41800  
    6767 *          one. A debug assertion is raised.
    6868 *
    69  * @param   pVM             VM Handle.
     69 * @param   pVM             Pointer to the VM.
    7070 * @param   enmType         Handler type. Any of the PGMPHYSHANDLERTYPE_PHYSICAL* enums.
    7171 * @param   GCPhys          Start physical address.
    … …  
    253253 *
    254254 * @returns VBox status code.
    255  * @param   pVM         VM Handle.
     255 * @param   pVM         Pointer to the VM.
    256256 * @param   GCPhys      Start physical address.
    257257 */
    … …  
    536536 *          For all return codes other than VERR_PGM_HANDLER_NOT_FOUND and VINF_SUCCESS the range is deregistered
    537537 *          and a new registration must be performed!
    538  * @param   pVM             VM handle.
     538 * @param   pVM             Pointer to the VM.
    539539 * @param   GCPhysCurrent   Current location.
    540540 * @param   GCPhys          New location.
    … …  
    643643 *
    644644 * @returns VBox status code.
    645  * @param   pVM             VM Handle.
     645 * @param   pVM             Pointer to the VM.
    646646 * @param   GCPhys          Start physical address.
    647647 * @param   pfnHandlerR3    The R3 handler.
    … …  
    694694 *
    695695 * @returns VBox status code.
    696  * @param   pVM             VM Handle.
     696 * @param   pVM             Pointer to the VM.
    697697 * @param   GCPhys          Start physical address of the handler.
    698698 * @param   GCPhysSplit     The split address.
    … …  
    760760 *
    761761 * @returns VBox status code.
    762  * @param   pVM             VM Handle.
     762 * @param   pVM             Pointer to the VM.
    763763 * @param   GCPhys1         Start physical address of the first handler.
    764764 * @param   GCPhys2         Start physical address of the second handler.
    … …  
    842842 *
    843843 * @returns VBox status code.
    844  * @param   pVM         VM Handle
     844 * @param   pVM         Pointer to the VM
    845845 * @param   GCPhys      The start address of the handler regions, i.e. what you
    846846 *                      passed to PGMR3HandlerPhysicalRegister(),
    … …  
    951951 *
    952952 * @returns VBox status code.
    953  * @param   pVM                 VM Handle
     953 * @param   pVM                 Pointer to the VM
    954954 * @param   GCPhys              The start address of the access handler. This
    955955 *                              must be a fully page aligned range or we risk
    … …  
    12401240 *
    12411241 * @returns boolean
    1242  * @param   pVM         VM Handle.
     1242 * @param   pVM         Pointer to the VM.
    12431243 * @param   GCPhys      Start physical address earlier passed to PGMR3HandlerPhysicalRegister().
    12441244 * @remarks Caller must take the PGM lock...
    … …  
    13041304 *
    13051305 * @returns true or false
    1306  * @param   pVM             VM handle.
     1306 * @param   pVM             Pointer to the VM.
    13071307 * @param   GCPtr           Virtual address.
    13081308 * @remarks Will acquire the PGM lock.

  • trunk/src/VBox/VMM/VMMAll/PGMAllMap.cpp

    r41783 r41800  
    117117 *
    118118 * @returns VBox status.
    119  * @param   pVM         VM handle.
     119 * @param   pVM         Pointer to the VM.
    120120 * @param   GCPtr       Virtual address of the first page in the range.
    121121 * @param   cb          Size (in bytes) of the range to apply the modification to.
    … …  
    134134 *
    135135 * @returns VBox status code.
    136  * @param   pVM         VM handle.
     136 * @param   pVM         Pointer to the VM.
    137137 * @param   GCPtr       Virtual address of the first page in the range.
    138138 * @param   cb          Size (in bytes) of the range to apply the modification to.

  • trunk/src/VBox/VMM/VMMAll/REMAll.cpp

    r41783 r41800  
    8080 * Insert pending notification
    8181 *
    82  * @param   pVM             VM Handle.
     82 * @param   pVM             Pointer to the VM.
    8383 * @param   pRec            Notification record to insert
    8484 */
    … …  
    132132 * Notification about a successful PGMR3HandlerPhysicalRegister() call.
    133133 *
    134  * @param   pVM             VM Handle.
     134 * @param   pVM             Pointer to the VM.
    135135 * @param   enmType         Handler type.
    136136 * @param   GCPhys          Handler range address.
    … …  
    153153 * Notification about a successful PGMR3HandlerPhysicalDeregister() operation.
    154154 *
    155  * @param   pVM             VM Handle.
     155 * @param   pVM             Pointer to the VM.
    156156 * @param   enmType         Handler type.
    157157 * @param   GCPhys          Handler range address.
    … …  
    176176 * Notification about a successful PGMR3HandlerPhysicalModify() call.
    177177 *
    178  * @param   pVM             VM Handle.
     178 * @param   pVM             Pointer to the VM.
    179179 * @param   enmType         Handler type.
    180180 * @param   GCPhysOld       Old handler range address.

  • trunk/src/VBox/VMM/VMMAll/SELMAll.cpp

    r41783 r41800  
    4545 *
    4646 * @returns Flat address.
    47  * @param   pVM     VM Handle.
     47 * @param   pVM     Pointer to the VM.
    4848 * @param   Sel     Selector part.
    4949 * @param   Addr    Address part.
    … …  
    7777 *
    7878 * @returns Flat address.
    79  * @param   pVM         VM Handle.
     79 * @param   pVM         Pointer to the VM.
    8080 * @param   SelReg      Selector register
    8181 * @param   pCtxCore    CPU context
    … …  
    689689 *
    690690 * @returns VBox status code.
    691  * @param   pVM     VM Handle.
     691 * @param   pVM     Pointer to the VM.
    692692 * @param   pVCpu   The virtual CPU handle.
    693693 * @param   SelCPL  Current privilege level. Get this from SS - CS might be conforming!
    … …  
    893893 *
    894894 * @returns DISCPUMODE according to the selector type (16, 32 or 64 bits)
    895  * @param   pVM     VM Handle.
     895 * @param   pVM     Pointer to the VM.
    896896 * @param   pVCpu   The virtual CPU handle.
    897897 * @param   Sel     The selector.
    … …  
    956956 *
    957957 * @returns Hypervisor's Trap 08 (\#DF) selector.
    958  * @param   pVM     VM Handle.
     958 * @param   pVM     Pointer to the VM.
    959959 */
    960960VMMDECL(RTSEL) SELMGetTrap8Selector(PVM pVM)
    … …  
    967967 * Sets EIP of Hypervisor's Trap 08 (\#DF) TSS.
    968968 *
    969  * @param   pVM     VM Handle.
     969 * @param   pVM     Pointer to the VM.
    970970 * @param   u32EIP  EIP of Trap 08 handler.
    971971 */
    … …  
    979979 * Sets ss:esp for ring1 in main Hypervisor's TSS.
    980980 *
    981  * @param   pVM     VM Handle.
     981 * @param   pVM     Pointer to the VM.
    982982 * @param   ss      Ring1 SS register value. Pass 0 if invalid.
    983983 * @param   esp     Ring1 ESP register value.
    … …  
    998998 *
    999999 * @returns VBox status code.
    1000  * @param   pVM     VM Handle.
     1000 * @param   pVM     Pointer to the VM.
    10011001 * @param   pSS     Ring1 SS register value.
    10021002 * @param   pEsp    Ring1 ESP register value.
    … …  
    10791079 *
    10801080 * @returns Pointer to the guest TSS, RTRCPTR_MAX if not being monitored.
    1081  * @param   pVM     VM Handle.
     1081 * @param   pVM     Pointer to the VM.
    10821082 */
    10831083VMMDECL(RTGCPTR) SELMGetGuestTSS(PVM pVM)

  • trunk/src/VBox/VMM/VMMAll/TMAll.cpp

    r41783 r41800  
    529529 * Checks that the timer queues are sane.
    530530 *
    531  * @param   pVM     VM handle.
     531 * @param   pVM     Pointer to the VM.
    532532 *
    533533 * @remarks Called while owning the lock.

  • trunk/src/VBox/VMM/VMMAll/TMAllVirtual.cpp

    r41783 r41800  
    370370 *
    371371 * @returns The timestamp.
    372  * @param   pVM     VM handle.
     372 * @param   pVM     Pointer to the VM.
    373373 *
    374374 * @remark  While the flow of time will never go backwards, the speed of the
    … …  
    390390 *
    391391 * @returns The timestamp.
    392  * @param   pVM     VM handle.
     392 * @param   pVM     Pointer to the VM.
    393393 *
    394394 * @remarks See TMVirtualGet.
    … …  
    419419 *
    420420 * @returns The timestamp.
    421  * @param   pVM                 VM handle.
     421 * @param   pVM                 Pointer to the VM.
    422422 * @param   u64                 raw virtual time.
    423423 * @param   off                 offVirtualSync.
    … …  
    620620 *
    621621 * @returns The timestamp.
    622  * @param   pVM                 VM handle.
     622 * @param   pVM                 Pointer to the VM.
    623623 * @param   fCheckTimers        Check timers or not
    624624 * @param   pcNsToDeadline      Where to return the number of nano seconds to
    … …  
    858858 *
    859859 * @returns The timestamp.
    860  * @param   pVM             VM handle.
     860 * @param   pVM             Pointer to the VM.
    861861 * @thread  EMT.
    862862 * @remarks May set the timer and virtual sync FFs.
    … …  
    873873 *
    874874 * @returns The timestamp.
    875  * @param   pVM             VM handle.
     875 * @param   pVM             Pointer to the VM.
    876876 * @thread  EMT.
    877877 * @remarks May set the timer and virtual sync FFs.
    … …  
    887887 *
    888888 * @returns The timestamp.
    889  * @param   pVM     VM handle.
     889 * @param   pVM     Pointer to the VM.
    890890 * @param   fCheckTimers    Check timers on the virtual clock or not.
    891891 * @thread  EMT.
    … …  
    903903 *
    904904 * @returns The timestamp.
    905  * @param   pVM                 VM handle.
     905 * @param   pVM                 Pointer to the VM.
    906906 * @param   pcNsToDeadline      Where to return the number of nano seconds to
    907907 *                              the next virtual sync timer deadline.
    … …  
    922922 *
    923923 * @returns The number of TMCLOCK_VIRTUAL ticks.
    924  * @param   pVM                 VM handle.
     924 * @param   pVM                 Pointer to the VM.
    925925 * @thread  EMT.
    926926 * @remarks May set the timer and virtual sync FFs.
    … …  
    938938 *
    939939 * @return  The current lag.
    940  * @param   pVM     VM handle.
     940 * @param   pVM     Pointer to the VM.
    941941 */
    942942VMM_INT_DECL(uint64_t) TMVirtualSyncGetLag(PVM pVM)
    … …  
    950950 *
    951951 * @return  The current catch0up percent. 0 means running at the same speed as the virtual clock.
    952  * @param   pVM     VM handle.
     952 * @param   pVM     Pointer to the VM.
    953953 */
    954954VMM_INT_DECL(uint32_t) TMVirtualSyncGetCatchUpPct(PVM pVM)
    … …  
    964964 *
    965965 * @returns The frequency.
    966  * @param   pVM     VM handle.
     966 * @param   pVM     Pointer to the VM.
    967967 */
    968968VMM_INT_DECL(uint64_t) TMVirtualGetFreq(PVM pVM)

  • trunk/src/VBox/VMM/VMMAll/TRPMAll.cpp

    r41783 r41800  
    314314 * probably also use this facility to save the original trap.
    315315 *
    316  * @param   pVM     VM handle.
     316 * @param   pVM     Pointer to the VM.
    317317 */
    318318VMMDECL(void) TRPMSaveTrap(PVMCPU pVCpu)
    … …  
    330330 * Multiple restores of a saved trap is possible.
    331331 *
    332  * @param   pVM     VM handle.
     332 * @param   pVM     Pointer to the VM.
    333333 */
    334334VMMDECL(void) TRPMRestoreTrap(PVMCPU pVCpu)

  • trunk/src/VBox/VMM/VMMAll/VMAll.cpp

    r41783 r41800  
    4242 *    return VM_SET_ERROR(pVM, VERR_OF_YOUR_CHOICE, "descriptive message");
    4343 *    @endcode
    44  * @param   pVM             VM handle. Must be non-NULL.
     44 * @param   pVM             Pointer to the VM. Must be non-NULL.
    4545 * @param   rc              VBox status code.
    4646 * @param   RT_SRC_POS_DECL Use RT_SRC_POS.
    … …  
    6666 *    return VM_SET_ERROR(pVM, VERR_OF_YOUR_CHOICE, "descriptive message");
    6767 *    @endcode
    68  * @param   pVM             VM handle. Must be non-NULL.
     68 * @param   pVM             Pointer to the VM. Must be non-NULL.
    6969 * @param   rc              VBox status code.
    7070 * @param   RT_SRC_POS_DECL Use RT_SRC_POS.
    … …  
    103103 * APIs for retrieving the VMERROR copy later.
    104104 *
    105  * @param   pVM             VM handle. Must be non-NULL.
     105 * @param   pVM             Pointer to the VM. Must be non-NULL.
    106106 * @param   rc              VBox status code.
    107107 * @param   RT_SRC_POS_DECL Use RT_SRC_POS.
    … …  
    298298 * APIs for retrieving the VMRUNTIMEERROR copy later.
    299299 *
    300  * @param   pVM             VM handle. Must be non-NULL.
     300 * @param   pVM             Pointer to the VM. Must be non-NULL.
    301301 * @param   fFlags          The error flags.
    302302 * @param   pszErrorId      Error ID string.

  • trunk/src/VBox/VMM/VMMR0/PDMR0Device.cpp

    r41783 r41800  
    914914 * Sets an irq on the PIC and I/O APIC.
    915915 *
    916  * @returns true if     delivered, false if postponed.
     916 * @returns true if delivered, false if postponed.
    917917 * @param   pVM         Pointer to the VM.
    918918 * @param   iIrq        The irq.
    … …  
    955955 *
    956956 * @returns See PFNPDMDEVREQHANDLERR0.
    957  * @param   pVM                 The VM handle (for validation).
    958  * @param   pReq                The request buffer.
     957 * @param   pVM                 Pointer to the VM (for validation).
     958 * @param   pReq                Pointer to the request buffer.
    959959 */
    960960VMMR0_INT_DECL(int) PDMR0DeviceCallReqHandler(PVM pVM, PPDMDEVICECALLREQHANDLERREQ pReq)

  • trunk/src/VBox/VMM/VMMR0/PDMR0Driver.cpp

    r35346 r41800  
    3434 *
    3535 * @returns See PFNPDMDRVREQHANDLERR0.
    36  * @param   pVM                 The VM handle (for validation).
    37  * @param   pReq                The request buffer.
     36 * @param   pVM                 Pointer to the VM (for validation).
     37 * @param   pReq                Pointer to the request buffer.
    3838 */
    3939VMMR0_INT_DECL(int) PDMR0DriverCallReqHandler(PVM pVM, PPDMDRIVERCALLREQHANDLERREQ pReq)

  • trunk/src/VBox/VMM/VMMR0/PGMR0.cpp

    r41783 r41800  
    379379 *
    380380 * @returns VBox status code (appropriate for trap handling and GC return).
    381  * @param   pVM                 VM Handle.
     381 * @param   pVM                 Pointer to the VM.
    382382 * @param   pVCpu               VMCPU Handle.
    383383 * @param   enmShwPagingMode    Paging mode for the nested page tables.

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

    r41783 r41800  
    141141 *
    142142 * @returns VBox status code.
    143  * @param   pVM             VM handle.
     143 * @param   pVM             Pointer to the VM.
    144144 */
    145145VMMR3DECL(int) CFGMR3Term(PVM pVM)
    … …  
    155155 *
    156156 * @returns Pointer to root node.
    157  * @param   pVM             VM handle.
     157 * @param   pVM             Pointer to the VM.
    158158 */
    159159VMMR3DECL(PCFGMNODE) CFGMR3GetRoot(PVM pVM)
    … …  
    820820 *
    821821 * @returns VBox status code.
    822  * @param   pVM     VM handle.
     822 * @param   pVM     Pointer to the VM.
    823823 */
    824824VMMR3DECL(int) CFGMR3ConstructDefaultTree(PVM pVM)

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

    r41783 r41800  
    19371937 *
    19381938 * @returns VBox status code.
    1939  * @param   pVM             VM Handle.
     1939 * @param   pVM             Pointer to the VM.
    19401940 * @param   pSSM            SSM operation handle.
    19411941 */
    … …  
    19741974 *
    19751975 * @returns VBox status code.
    1976  * @param   pVM             VM Handle.
     1976 * @param   pVM             Pointer to the VM.
    19771977 * @param   pCpumctx16      Version 1.6 CPUMCTX
    19781978 */
    … …  
    23862386 * Formats a full register dump.
    23872387 *
    2388  * @param   pVM         VM Handle.
     2388 * @param   pVM         Pointer to the VM.
    23892389 * @param   pCtx        The context to format.
    23902390 * @param   pCtxCore    The context core to format.
    … …  
    26052605 * Display all cpu states and any other cpum info.
    26062606 *
    2607  * @param   pVM         VM Handle.
     2607 * @param   pVM         Pointer to the VM.
    26082608 * @param   pHlp        The info helper functions.
    26092609 * @param   pszArgs     Arguments, ignored.
    … …  
    26622662 * Display the guest cpu state.
    26632663 *
    2664  * @param   pVM         VM Handle.
     2664 * @param   pVM         Pointer to the VM.
    26652665 * @param   pHlp        The info helper functions.
    26662666 * @param   pszArgs     Arguments, ignored.
    … …  
    26872687 * Display the current guest instruction
    26882688 *
    2689  * @param   pVM         VM Handle.
     2689 * @param   pVM         Pointer to the VM.
    26902690 * @param   pHlp        The info helper functions.
    26912691 * @param   pszArgs     Arguments, ignored.
    … …  
    27102710 * Display the hypervisor cpu state.
    27112711 *
    2712  * @param   pVM         VM Handle.
     2712 * @param   pVM         Pointer to the VM.
    27132713 * @param   pHlp        The info helper functions.
    27142714 * @param   pszArgs     Arguments, ignored.
    … …  
    27312731 * Display the host cpu state.
    27322732 *
    2733  * @param   pVM         VM Handle.
     2733 * @param   pVM         Pointer to the VM.
    27342734 * @param   pHlp        The info helper functions.
    27352735 * @param   pszArgs     Arguments, ignored.
    … …  
    28722872 * Display the guest CpuId leaves.
    28732873 *
    2874  * @param   pVM         VM Handle.
     2874 * @param   pVM         Pointer to the VM.
    28752875 * @param   pHlp        The info helper functions.
    28762876 * @param   pszArgs     "terse", "default" or "verbose".
    … …  
    36053605 *
    36063606 * @returns VBox status code.
    3607  * @param   pVM         VM Handle
     3607 * @param   pVM         Pointer to the VM
    36083608 * @param   pVCpu       VMCPU Handle
    36093609 * @param   pCtx        CPU context

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

    r41791 r41800  
    469469 * @returns VBox status code.
    470470 * @param   pNode           Current node
    471  * @param   pVM1            VM Handle
     471 * @param   pVM1            Pointer to the VM
    472472 */
    473473static DECLCALLBACK(int) SavePageState(PAVLPVNODECORE pNode, void *pVM1)
    … …  
    496496 *
    497497 * @returns VBox status code.
    498  * @param   pVM             VM Handle.
     498 * @param   pVM             Pointer to the VM.
    499499 * @param   pSSM            SSM operation handle.
    500500 */
    … …  
    545545 *
    546546 * @returns VBox status code.
    547  * @param   pVM             VM Handle.
     547 * @param   pVM             Pointer to the VM.
    548548 * @param   pSSM            SSM operation handle.
    549549 * @param   uVersion        Data layout version.
    … …  
    20832083 * Callback for delayed writes from non-EMT threads
    20842084 *
    2085  * @param   pVM             VM Handle.
     2085 * @param   pVM             Pointer to the VM.
    20862086 * @param   GCPtr           The virtual address the guest is writing to. (not correct if it's an alias!)
    20872087 * @param   cbBuf           How much it's reading/writing.
    … …  
    21012101 * @returns VINF_SUCCESS if the handler have carried out the operation.
    21022102 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    2103  * @param   pVM             VM Handle.
     2103 * @param   pVM             Pointer to the VM.
    21042104 * @param   GCPtr           The virtual address the guest is writing to. (not correct if it's an alias!)
    21052105 * @param   pvPtr           The HC mapping of that address.
    … …  
    21442144 * \#PF Handler callback for invalidation of virtual access handler ranges.
    21452145 *
    2146  * @param   pVM             VM Handle.
     2146 * @param   pVM             Pointer to the VM.
    21472147 * @param   GCPtr           The virtual address the guest has changed.
    21482148 */

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

    r41783 r41800  
    104104 *
    105105 * @returns Previous command.
    106  * @param   pVM     VM Handle.
     106 * @param   pVM     Pointer to the VM.
    107107 * @param   enmCmd  The command.
    108108 */
    … …  
    132132 *
    133133 * @returns VBox status code.
    134  * @param   pVM     VM handle.
     134 * @param   pVM     Pointer to the VM.
    135135 */
    136136VMMR3DECL(int) DBGFR3Init(PVM pVM)
    … …  
    155155 *
    156156 * @returns VBox status code.
    157  * @param   pVM     VM Handle.
     157 * @param   pVM     Pointer to the VM.
    158158 */
    159159VMMR3DECL(int) DBGFR3Term(PVM pVM)
    … …  
    226226 * whenever the VMM need to relocate it self inside the GC.
    227227 *
    228  * @param   pVM         VM handle.
     228 * @param   pVM         Pointer to the VM.
    229229 * @param   offDelta    Relocation delta relative to old location.
    230230 */
    … …  
    240240 *
    241241 * @returns True is a debugger have attached.
    242  * @param   pVM         VM handle.
     242 * @param   pVM         Pointer to the VM.
    243243 * @param   enmEvent    Event.
    244244 */
    … …  
    297297 * @returns VINF_SUCCESS normally.
    298298 * @returns VERR_DBGF_RAISE_FATAL_ERROR to pretend a fatal error happened.
    299  * @param   pVM         VM Handle.
     299 * @param   pVM         Pointer to the VM.
    300300 */
    301301VMMR3DECL(int) DBGFR3VMMForcedAction(PVM pVM)
    … …  
    608608 *
    609609 * @returns VBox status. (clearify)
    610  * @param   pVM     VM handle.
     610 * @param   pVM     Pointer to the VM.
    611611 */
    612612static int dbgfR3VMMWait(PVM pVM)
    … …  
    734734 *
    735735 * @returns VBox status. (clearify!)
    736  * @param   pVM                 VM Handle.
     736 * @param   pVM                 Pointer to the VM.
    737737 * @param   enmCmd              The command in question.
    738738 * @param   pCmdData            Pointer to the command data.
    … …  
    856856 *
    857857 * @returns VBox status code.
    858  * @param   pVM     VM Handle.
     858 * @param   pVM     Pointer to the VM.
    859859 */
    860860VMMR3DECL(int) DBGFR3Attach(PVM pVM)
    … …  
    904904 *
    905905 * @returns VBox status code.
    906  * @param   pVM     VM Handle.
     906 * @param   pVM     Pointer to the VM.
    907907 */
    908908VMMR3DECL(int) DBGFR3Detach(PVM pVM)
    … …  
    950950 *
    951951 * @returns VBox status. Will not return VBOX_INTERRUPTED.
    952  * @param   pVM         VM handle.
     952 * @param   pVM         Pointer to the VM.
    953953 * @param   cMillies    Number of millis to wait.
    954954 * @param   ppEvent     Where to store the event pointer.
    … …  
    984984 *
    985985 * @returns VBox status.
    986  * @param   pVM     VM handle.
     986 * @param   pVM     Pointer to the VM.
    987987 */
    988988VMMR3DECL(int) DBGFR3Halt(PVM pVM)
    … …  
    10111011 * @returns True if halted.
    10121012 * @returns False if not halted.
    1013  * @param   pVM     VM handle.
     1013 * @param   pVM     Pointer to the VM.
    10141014 */
    10151015VMMR3DECL(bool) DBGFR3IsHalted(PVM pVM)
    … …  
    10291029 * @returns True if waitable.
    10301030 * @returns False if not waitable.
    1031  * @param   pVM     VM handle.
     1031 * @param   pVM     Pointer to the VM.
    10321032 */
    10331033VMMR3DECL(bool) DBGFR3CanWait(PVM pVM)
    … …  
    10441044 *
    10451045 * @returns VBox status.
    1046  * @param   pVM     VM handle.
     1046 * @param   pVM     Pointer to the VM.
    10471047 */
    10481048VMMR3DECL(int) DBGFR3Resume(PVM pVM)
    … …  
    10721072 *
    10731073 * @returns VBox status.
    1074  * @param   pVM     VM handle.
     1074 * @param   pVM     Pointer to the VM.
    10751075 * @param   idCpu   The ID of the CPU to single step on.
    10761076 */

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

    r41783 r41800  
    9090 *
    9191 * @returns VBox status code.
    92  * @param   pVM         VM handle
     92 * @param   pVM         Pointer to the VM
    9393 * @param   pVCpu       VMCPU handle
    9494 * @param   pSelInfo    The selector info.
    … …  
    561561 *
    562562 * @returns VBox status code.
    563  * @param   pVM             VM handle.
     563 * @param   pVM             Pointer to the VM.
    564564 * @param   idCpu           The ID of virtual CPU.
    565565 * @param   Sel             The code selector. This used to determine the 32/16 bit ness and
    … …  
    652652 *
    653653 * @returns VBox status code.
    654  * @param   pVM             VM handle.
     654 * @param   pVM             Pointer to the VM.
    655655 * @param   pVCpu           The virtual CPU handle, defaults to CPU 0 if NULL.
    656656 * @param   Sel             The code selector. This used to determine the 32/16 bit-ness and

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

    r41783 r41800  
    7878 *
    7979 * @returns VBox status code.
    80  * @param   pVM     VM handle.
     80 * @param   pVM     Pointer to the VM.
    8181 */
    8282int dbgfR3InfoInit(PVM pVM)
    … …  
    108108 *
    109109 * @returns VBox status code.
    110  * @param   pVM     VM handle.
     110 * @param   pVM     Pointer to the VM.
    111111 */
    112112int dbgfR3InfoTerm(PVM pVM)
    … …  
    211211 *
    212212 * @returns VBox status code.
    213  * @param   pVM         VM handle.
     213 * @param   pVM         Pointer to the VM.
    214214 * @param   pszName     The identifier of the info.
    215215 * @param   pszDesc     The description of the info and any arguments the handler may take.
    … …  
    278278 *
    279279 * @returns VBox status code.
    280  * @param   pVM         VM handle.
     280 * @param   pVM         Pointer to the VM.
    281281 * @param   pszName     The identifier of the info.
    282282 * @param   pszDesc     The description of the info and any arguments the handler may take.
    … …  
    324324 *
    325325 * @returns VBox status code.
    326  * @param   pVM         VM handle.
     326 * @param   pVM         Pointer to the VM.
    327327 * @param   pszName     The identifier of the info.
    328328 * @param   pszDesc     The description of the info and any arguments the handler may take.
    … …  
    370370 *
    371371 * @returns VBox status code.
    372  * @param   pVM         VM handle.
     372 * @param   pVM         Pointer to the VM.
    373373 * @param   pszName     The identifier of the info.
    374374 * @param   pszDesc     The description of the info and any arguments the handler may take.
    … …  
    385385 *
    386386 * @returns VBox status code.
    387  * @param   pVM         VM handle.
     387 * @param   pVM         Pointer to the VM.
    388388 * @param   pszName     The identifier of the info.
    389389 * @param   pszDesc     The description of the info and any arguments the handler may take.
    … …  
    425425 *
    426426 * @returns VBox status code.
    427  * @param   pVM         VM handle.
     427 * @param   pVM         Pointer to the VM.
    428428 * @param   pszName     The identifier of the info.
    429429 * @param   pszDesc     The description of the info and any arguments the handler may take.
    … …  
    466466 *
    467467 * @returns VBox status code.
    468  * @param   pVM         VM Handle.
     468 * @param   pVM         Pointer to the VM.
    469469 * @param   pDevIns     Device instance.
    470470 * @param   pszName     The identifier of the info. If NULL all owned by the device.
    … …  
    541541 *
    542542 * @returns VBox status code.
    543  * @param   pVM         VM Handle.
     543 * @param   pVM         Pointer to the VM.
    544544 * @param   pDrvIns     Driver instance.
    545545 * @param   pszName     The identifier of the info. If NULL all owned by the driver.
    … …  
    617617 *
    618618 * @returns VBox status code.
    619  * @param   pVM         VM Handle.
     619 * @param   pVM         Pointer to the VM.
    620620 * @param   pszName     The identifier of the info.
    621621 * @param   enmType     The info owner type.
    … …  
    666666 *
    667667 * @returns VBox status code.
    668  * @param   pVM         VM Handle.
     668 * @param   pVM         Pointer to the VM.
    669669 * @param   pszName     The identifier of the info. If NULL all owned by the device.
    670670 */
    … …  
    680680 *
    681681 * @returns VBox status code.
    682  * @param   pVM         VM Handle.
     682 * @param   pVM         Pointer to the VM.
    683683 * @param   pszName     The identifier of the info. If NULL all owned by the device.
    684684 */
    … …  
    788788 *
    789789 * @returns VBox status code.
    790  * @param   pVM         VM handle.
     790 * @param   pVM         Pointer to the VM.
    791791 * @param   pszName     The identifier of the info to display.
    792792 * @param   pszArgs     Arguments to the info handler.
    … …  
    803803 *
    804804 * @returns VBox status code.
    805  * @param   pVM         VM handle.
     805 * @param   pVM         Pointer to the VM.
    806806 * @param   idCpu       The CPU to exectue the request on.  Pass NIL_VMCPUID
    807807 *                      to not involve any EMT.
    … …  
    944944 *
    945945 * @returns VBox status code.
    946  * @param   pVM             VM handle.
     946 * @param   pVM             Pointer to the VM.
    947947 * @param   pfnCallback     Pointer to callback function.
    948948 * @param   pvUser          User argument to pass to the callback.

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

    r41783 r41800  
    446446 *          pagetable or page backing the selector table wasn't present.
    447447 *
    448  * @param   pVM         VM handle.
     448 * @param   pVM         Pointer to the VM.
    449449 * @param   idCpu       The ID of the virtual CPU context.
    450450 * @param   Sel         The selector to get info about.

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

    r41783 r41800  
    428428 *          Failure will stop the search and return the return code.
    429429 *          Warnings will be ignored and not returned.
    430  * @param   pVM             VM Handle.
     430 * @param   pVM             Pointer to the VM.
    431431 * @param   pszFilename     Module filename.
    432432 * @param   pszName         Module name. (short and unique)
    … …  
    455455 *
    456456 * @returns VBox status.
    457  * @param   pVM             VM Handle.
     457 * @param   pVM             Pointer to the VM.
    458458 */
    459459int dbgfR3SymTerm(PVM pVM)
    … …  
    690690 *
    691691 * @returns VBox status.
    692  * @param   pVM             VM Handle.
     692 * @param   pVM             Pointer to the VM.
    693693 * @param   pszFilename     Path to the file containing the symbol information.
    694694 *                          This can be the executable image, a flat symbol file of some kind or stripped debug info.
    … …  
    833833 *
    834834 * @returns VBox status.
    835  * @param   pVM             VM Handle.
     835 * @param   pVM             Pointer to the VM.
    836836 * @param   ModuleAddress   Module address. Use 0 if no module.
    837837 * @param   SymbolAddress   Symbol address
    … …  
    876876 *
    877877 * @returns VBox status.
    878  * @param   pVM                 VM handle.
     878 * @param   pVM                 Pointer to the VM.
    879879 * @param   Address             Address.
    880880 * @param   poffDisplacement    Where to store the symbol displacement from Address.
    … …  
    965965 *
    966966 * @returns VBox status.
    967  * @param   pVM                 VM handle.
     967 * @param   pVM                 Pointer to the VM.
    968968 * @param   pszSymbol           Symbol name.
    969969 * @param   pSymbol             Where to store the symbol info.
    … …  
    10211021 *
    10221022 * @returns VBox status.
    1023  * @param   pVM                 VM handle.
     1023 * @param   pVM                 Pointer to the VM.
    10241024 * @param   Address             Address.
    10251025 * @param   poffDisplacement    Where to store the line displacement from Address.
    … …  
    10851085 * @returns Pointer to the line. Must be freed using DBGFR3LineFree().
    10861086 * @returns NULL if the line was not found or if we're out of memory.
    1087  * @param   pVM                 VM handle.
     1087 * @param   pVM                 Pointer to the VM.
    10881088 * @param   Address             Address.
    10891089 * @param   poffDisplacement    Where to store the line displacement from Address.

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

    r41783 r41800  
    493493 *
    494494 * @returns VBox status code.
    495  * @param   pVM             VM Handle.
     495 * @param   pVM             Pointer to the VM.
    496496 * @param   pSSM            SSM operation handle.
    497497 */
    … …  
    532532 *
    533533 * @returns VBox status code.
    534  * @param   pVM             VM Handle.
     534 * @param   pVM             Pointer to the VM.
    535535 * @param   pSSM            SSM operation handle.
    536536 * @param   uVersion        Data layout version.
    … …  
    716716 *
    717717 * @returns VBox status code for EM.
    718  * @param   pVM     VM handle.
     718 * @param   pVM     Pointer to the VM.
    719719 * @param   pVCpu   VMCPU handle.
    720720 * @param   rc      Current EM VBox status code..
    … …  
    892892 *          VINF_EM_RESCHEDULE, VINF_EM_SUSPEND, VINF_EM_RESET and VINF_EM_TERMINATE.
    893893 *
    894  * @param   pVM         VM handle.
     894 * @param   pVM         Pointer to the VM.
    895895 * @param   pVCpu       VMCPU handle.
    896896 */
    … …  
    952952 *          VINF_EM_SUSPEND, VINF_EM_RESET and VINF_EM_TERMINATE.
    953953 *
    954  * @param   pVM         VM handle.
     954 * @param   pVM         Pointer to the VM.
    955955 * @param   pVCpu       VMCPU handle.
    956956 * @param   pfFFDone    Where to store an indicator telling whether or not
    … …  
    13251325 * @returns rc or a fatal status code.
    13261326 *
    1327  * @param   pVM         VM handle.
     1327 * @param   pVM         Pointer to the VM.
    13281328 * @param   pVCpu       VMCPU handle.
    13291329 * @param   rc          The current rc.
    … …  
    13641364 *          VINF_EM_SUSPEND, VINF_EM_RESET and VINF_EM_TERMINATE.
    13651365 *
    1366  * @param   pVM         VM handle.
     1366 * @param   pVM         Pointer to the VM.
    13671367 * @param   pVCpu       VMCPU handle.
    13681368 * @param   rc          The current rc.
    … …  
    23092309 * Notify EM of a state change (used by FTM)
    23102310 *
    2311  * @param   pVM             VM Handle.
     2311 * @param   pVM             Pointer to the VM.
    23122312 */
    23132313VMMR3DECL(int) EMR3NotifySuspend(PVM pVM)
    … …  
    23242324 * Notify EM of a state change (used by FTM)
    23252325 *
    2326  * @param   pVM             VM Handle.
     2326 * @param   pVM             Pointer to the VM.
    23272327 */
    23282328VMMR3DECL(int) EMR3NotifyResume(PVM pVM)

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

    r41783 r41800  
    158158 * @returns VBox status code suitable for EM.
    159159 *
    160  * @param   pVM         VM handle.
     160 * @param   pVM         Pointer to the VM.
    161161 * @param   pVCpu       VMCPU handle
    162162 * @param   rcRC        Return code from RC.
    … …  
    259259 *
    260260 * @returns VBox status code suitable for EM.
    261  * @param   pVM         VM handle.
     261 * @param   pVM         Pointer to the VM.
    262262 * @param   pVCpu       VMCPU handle.
    263263 * @param   pszPrefix   Disassembly prefix. If not NULL we'll disassemble the
    … …  
    278278 *
    279279 * @returns VBox status code suitable for EM.
    280  * @param   pVM         VM handle.
     280 * @param   pVM         Pointer to the VM.
    281281 * @param   pVCpu       VMCPU handle.
    282282 */
    … …  
    459459 *          VINF_EM_RESCHEDULE_REM, VINF_EM_SUSPEND, VINF_EM_RESET and VINF_EM_TERMINATE.
    460460 *
    461  * @param   pVM         VM handle.
     461 * @param   pVM         Pointer to the VM.
    462462 * @param   pVCpu       VMCPU handle.
    463463 * @param   pfFFDone    Where to store an indicator telling whether or not

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

    r41783 r41800  
    7676/**
    7777 * Just a braindead function to keep track of cli addresses.
    78  * @param   pVM         VM handle.
     78 * @param   pVM         Pointer to the VM.
    7979 * @param   pVMCPU      VMCPU handle.
    8080 * @param   GCPtrInstr  The EIP of the cli instruction.
    … …  
    257257 * @returns VBox status code suitable for EM.
    258258 *
    259  * @param   pVM         VM handle.
     259 * @param   pVM         Pointer to the VM.
    260260 * @param   pVCpu       VMCPU handle
    261261 * @param   rcGC        GC return code
    … …  
    391391 *
    392392 * @returns VBox status code suitable for EM.
    393  * @param   pVM         VM handle.
     393 * @param   pVM         Pointer to the VM.
    394394 * @param   pVCpu       VMCPU handle.
    395395 * @param   pszPrefix   Disassembly prefix. If not NULL we'll disassemble the
    … …  
    410410 *
    411411 * @returns VBox status code suitable for EM.
    412  * @param   pVM         VM handle.
     412 * @param   pVM         Pointer to the VM.
    413413 * @param   pVCpu       VMCPU handle.
    414414 */
    … …  
    504504 *
    505505 * @returns VBox status code suitable for EM.
    506  * @param   pVM         VM handle.
     506 * @param   pVM         Pointer to the VM.
    507507 * @param   pVCpu       VMCPU handle.
    508508 */
    … …  
    664664 *
    665665 * @returns VBox status code suitable for EM.
    666  * @param   pVM     VM handle.
     666 * @param   pVM     Pointer to the VM.
    667667 * @param   pVCpu       VMCPU handle.
    668668 */
    … …  
    723723 *
    724724 * @returns VBox status code suitable for EM.
    725  * @param   pVM     VM handle.
     725 * @param   pVM     Pointer to the VM.
    726726 * @param   pVCpu   VMCPU handle.
    727727 * @param   pCtx    CPU context
    … …  
    907907 *
    908908 * @returns VBox status code suitable for EM.
    909  * @param   pVM     VM handle.
     909 * @param   pVM     Pointer to the VM.
    910910 * @param   pVCpu   VMCPU handle;
    911911 */
    … …  
    13281328 *          VINF_EM_RESCHEDULE_REM, VINF_EM_SUSPEND, VINF_EM_RESET and VINF_EM_TERMINATE.
    13291329 *
    1330  * @param   pVM         VM handle.
     1330 * @param   pVM         Pointer to the VM.
    13311331 * @param   pVCpu       VMCPU handle.
    13321332 * @param   pfFFDone    Where to store an indicator telling whether or not

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

    r41783 r41800  
    676676 * PGMR3PhysEnumDirtyFTPages callback for syncing dirty physical pages
    677677 *
    678  * @param   pVM             VM Handle.
     678 * @param   pVM             Pointer to the VM.
    679679 * @param   GCPhys          GC physical address
    680680 * @param   pRange          HC virtual address of the page(s)
    … …  
    848848 *
    849849 * @returns VBox status code.
    850  * @param   pVM             VM Handle.
     850 * @param   pVM             Pointer to the VM.
    851851 */
    852852static int ftmR3SyncMem(PVM pVM)

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

    r41783 r41800  
    16271627 * needs to be removed.
    16281628 *
    1629  * @param   pVM     VM handle.
     1629 * @param   pVM     Pointer to the VM.
    16301630 */
    16311631VMMR3DECL(void) HWACCMR3Reset(PVM pVM)
    … …  
    26382638 *
    26392639 * @returns VBox status code.
    2640  * @param   pVM             VM Handle.
     2640 * @param   pVM             Pointer to the VM.
    26412641 * @param   pSSM            SSM operation handle.
    26422642 */
    … …  
    27212721 *
    27222722 * @returns VBox status code.
    2723  * @param   pVM             VM Handle.
     2723 * @param   pVM             Pointer to the VM.
    27242724 * @param   pSSM            SSM operation handle.
    27252725 * @param   uVersion        Data layout version.

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

    r40442 r41800  
    260260 * The VM is being reset.
    261261 *
    262  * @param   pVM     VM handle.
     262 * @param   pVM     Pointer to the VM.
    263263 */
    264264VMMR3_INT_DECL(void) IOMR3Reset(PVM pVM)
    … …  
    393393 * @returns Pointer to new stats node.
    394394 *
    395  * @param   pVM         VM handle.
     395 * @param   pVM         Pointer to the VM.
    396396 * @param   Port        Port.
    397397 * @param   pszDesc     Description.
    … …  
    446446 * @returns Pointer to new stats node.
    447447 *
    448  * @param   pVM         VM handle.
     448 * @param   pVM         Pointer to the VM.
    449449 * @param   GCPhys      The address.
    450450 * @param   pszDesc     Description.
    … …  
    498498 * @returns VBox status code.
    499499 *
    500  * @param   pVM                 VM handle.
     500 * @param   pVM                 Pointer to the VM.
    501501 * @param   pDevIns             PDM device instance owning the port range.
    502502 * @param   PortStart           First port number in the range.
    … …  
    596596 * @returns VBox status code.
    597597 *
    598  * @param   pVM                 VM handle.
     598 * @param   pVM                 Pointer to the VM.
    599599 * @param   pDevIns             PDM device instance owning the port range.
    600600 * @param   PortStart           First port number in the range.
    … …  
    710710 * @returns VBox status code.
    711711 *
    712  * @param   pVM                 VM handle.
     712 * @param   pVM                 Pointer to the VM.
    713713 * @param   pDevIns             PDM device instance owning the port range.
    714714 * @param   PortStart           First port number in the range.
    … …  
    12681268 * Display all registered I/O port ranges.
    12691269 *
    1270  * @param   pVM         VM Handle.
     1270 * @param   pVM         Pointer to the VM.
    12711271 * @param   pHlp        The info helpers.
    12721272 * @param   pszArgs     Arguments, ignored.
    … …  
    13931393 * @returns VBox status code.
    13941394 *
    1395  * @param   pVM                 VM handle.
     1395 * @param   pVM                 Pointer to the VM.
    13961396 * @param   pDevIns             PDM device instance owning the MMIO range.
    13971397 * @param   GCPhysStart         First physical address in the range.
    … …  
    15111511 * @returns VBox status code.
    15121512 *
    1513  * @param   pVM                 VM handle.
     1513 * @param   pVM                 Pointer to the VM.
    15141514 * @param   pDevIns             PDM device instance owning the MMIO range.
    15151515 * @param   GCPhysStart         First physical address in the range.
    … …  
    15671567 * @returns VBox status code.
    15681568 *
    1569  * @param   pVM                 VM handle.
     1569 * @param   pVM                 Pointer to the VM.
    15701570 * @param   pDevIns             PDM device instance owning the MMIO range.
    15711571 * @param   GCPhysStart         First physical address in the range.
    … …  
    17501750 * Display registered MMIO ranges to the log.
    17511751 *
    1752  * @param   pVM         VM Handle.
     1752 * @param   pVM         Pointer to the VM.
    17531753 * @param   pHlp        The info helpers.
    17541754 * @param   pszArgs     Arguments, ignored.

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

    r41783 r41800  
    506506 *
    507507 * @returns VBox status code.
    508  * @param   pVM             VM Handle.
     508 * @param   pVM             Pointer to the VM.
    509509 * @param   pSSM            SSM operation handle.
    510510 */
    … …  
    523523 *
    524524 * @returns VBox status code.
    525  * @param   pVM             VM Handle.
     525 * @param   pVM             Pointer to the VM.
    526526 * @param   pSSM            SSM operation handle.
    527527 * @param   uVersion       Data layout version.
    … …  
    707707 *
    708708 * @returns VBox status.
    709  * @param   pVM         VM handle.
     709 * @param   pVM         Pointer to the VM.
    710710 * @param   HCPhys      The host context virtual address.
    711711 * @param   ppv         Where to store the resulting address.

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

    r41783 r41800  
    152152 *
    153153 * @returns Pointer to allocated memory.
    154  * @param   pVM         VM handle.
     154 * @param   pVM         Pointer to the VM.
    155155 * @param   enmTag      Statistics tag. Statistics are collected on a per tag
    156156 *                      basis in addition to a global one. Thus we can easily
    … …  
    192192 *
    193193 * @returns Pointer to allocated memory.
    194  * @param   pVM         VM handle.
     194 * @param   pVM         Pointer to the VM.
    195195 * @param   enmTag      Statistics tag. Statistics are collected on a per tag
    196196 *                      basis in addition to a global one. Thus we can easily
    … …  
    231231 *
    232232 * @returns Pointer to allocated memory.
    233  * @param   pVM         VM handle.
     233 * @param   pVM         Pointer to the VM.
    234234 * @param   enmTag      Statistics tag. Statistics are collected on a per tag
    235235 *                      basis in addition to a global one. Thus we can easily
    … …  
    271271 *
    272272 * @returns Pointer to allocated memory.
    273  * @param   pVM         VM handle.
     273 * @param   pVM         Pointer to the VM.
    274274 * @param   enmTag      Statistics tag. Statistics are collected on a per tag
    275275 *                      basis in addition to a global one. Thus we can easily

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

    r41783 r41800  
    405405 * @return VBox status code.
    406406 *
    407  * @param   pVM         VM handle.
     407 * @param   pVM         Pointer to the VM.
    408408 * @param   pvR3        Ring-3 address of the memory. Must be page aligned!
    409409 * @param   pvR0        Optional ring-0 address of the memory.
    … …  
    458458 * @return VBox status code.
    459459 *
    460  * @param   pVM         VM handle.
     460 * @param   pVM         Pointer to the VM.
    461461 * @param   GCPhys      Guest context physical address of the memory to be mapped. Must be page aligned!
    462462 * @param   cb          Size of the memory. Will be rounded up to nearest page.
    … …  
    608608 * @return VBox status code.
    609609 *
    610  * @param   pVM         VM handle.
     610 * @param   pVM         Pointer to the VM.
    611611 * @param   pvR3        The ring-3 address of the memory, must be page aligned.
    612612 * @param   pvR0        The ring-0 address of the memory, must be page aligned. (optional)
    … …  
    687687 * @return VBox status code.
    688688 *
    689  * @param   pVM         VM handle.
     689 * @param   pVM         Pointer to the VM.
    690690 * @param   cb          Size of the memory. Will be rounded up to nearest page.
    691691 * @param   pszDesc     Mapping description.
    … …  
    11661166 *
    11671167 * @returns HC physical address.
    1168  * @param   pVM         VM Handle
     1168 * @param   pVM         Pointer to the VM
    11691169 * @param   pvR3        Host context virtual address.
    11701170 */
    … …  
    13041304 *
    13051305 * @returns HC virtual address.
    1306  * @param   pVM         VM Handle
     1306 * @param   pVM         Pointer to the VM
    13071307 * @param   HCPhys      Host context physical address.
    13081308 */
    … …  
    13221322 *
    13231323 * @returns VBox status.
    1324  * @param   pVM         VM Handle
     1324 * @param   pVM         Pointer to the VM
    13251325 * @param   HCPhys      Host context physical address.
    13261326 * @param   ppv         Where to store the HC virtual address.
    … …  
    13411341 *
    13421342 * @returns VBox status.
    1343  * @param   pVM         VM handle.
     1343 * @param   pVM         Pointer to the VM.
    13441344 * @param   pvDst       Destination address (HC of course).
    13451345 * @param   GCPtr       GC virtual address.

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

    r35346 r41800  
    5252 *
    5353 * @return  VBox status.
    54  * @param   pVM     VM handle.
     54 * @param   pVM     Pointer to the VM.
    5555 * @thread  The Emulation Thread.
    5656 */
    … …  
    104104 * Release all locks and free the allocated memory.
    105105 *
    106  * @param   pVM     VM handle.
     106 * @param   pVM     Pointer to the VM.
    107107 * @thread  The Emulation Thread.
    108108 */
    … …  
    389389 * @returns Pointer to the allocated page page.
    390390 * @returns NULL on failure.
    391  * @param   pVM         VM handle.
     391 * @param   pVM         Pointer to the VM.
    392392 * @thread  The Emulation Thread.
    393393 */
    … …  
    408408 * @returns Pointer to the allocated page page.
    409409 * @returns NIL_RTHCPHYS on failure.
    410  * @param   pVM         VM handle.
     410 * @param   pVM         Pointer to the VM.
    411411 * @thread  The Emulation Thread.
    412412 */
    … …  
    426426 * MMR3PageAllocPhys().
    427427 *
    428  * @param   pVM         VM handle.
     428 * @param   pVM         Pointer to the VM.
    429429 * @param   pvPage      Pointer to the page.
    430430 * @thread  The Emulation Thread.
    … …  
    441441 * @returns Pointer to the allocated page.
    442442 * @returns NULL on failure.
    443  * @param   pVM         VM handle.
     443 * @param   pVM         Pointer to the VM.
    444444 * @thread  The Emulation Thread.
    445445 */
    … …  
    453453 * Frees a page allocated from the page pool by MMR3PageAllocLow().
    454454 *
    455  * @param   pVM         VM handle.
     455 * @param   pVM         Pointer to the VM.
    456456 * @param   pvPage      Pointer to the page.
    457457 * @thread  The Emulation Thread.
    … …  
    468468 * and MMR3PageAllocLow().
    469469 *
    470  * @param   pVM         VM handle.
     470 * @param   pVM         Pointer to the VM.
    471471 * @param   HCPhysPage  The physical address of the page to be freed.
    472472 * @thread  The Emulation Thread.
    … …  
    491491 *
    492492 * @returns Pointer to the dummy page.
    493  * @param   pVM         VM handle.
     493 * @param   pVM         Pointer to the VM.
    494494 * @thread  The Emulation Thread.
    495495 */
    … …  
    515515 *
    516516 * @returns Pointer to the dummy page.
    517  * @param   pVM         VM handle.
     517 * @param   pVM         Pointer to the VM.
    518518 * @thread  The Emulation Thread.
    519519 */

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

    r41783 r41800  
    125125 *
    126126 * @returns Pointer to allocated memory.
    127  * @param   pVM         VM handle.
     127 * @param   pVM         Pointer to the VM.
    128128 * @param   enmTag      Statistics tag. Statistics are collected on a per tag
    129129 *                      basis in addition to a global one. Thus we can easily
    … …  
    142142 *
    143143 * @returns Pointer to allocated memory.
    144  * @param   pVM         VM handle.
     144 * @param   pVM         Pointer to the VM.
    145145 * @param   enmTag      Statistics tag. Statistics are collected on a per tag
    146146 *                      basis in addition to a global one. Thus we can easily
    … …  
    166166 *
    167167 * @returns Pointer to allocated memory.
    168  * @param   pVM         VM handle.
     168 * @param   pVM         Pointer to the VM.
    169169 * @param   enmTag      Statistics tag. Statistics are collected on a per tag
    170170 *                      basis in addition to a global one. Thus we can easily
    … …  
    183183 *
    184184 * @returns Pointer to allocated memory.
    185  * @param   pVM         VM handle.
     185 * @param   pVM         Pointer to the VM.
    186186 * @param   enmTag      Statistics tag. Statistics are collected on a per tag
    187187 *                      basis in addition to a global one. Thus we can easily

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

    r41783 r41800  
    901901 * @returns VINF_SUCCESS if the handler have carried out the operation.
    902902 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    903  * @param   pVM             VM Handle.
     903 * @param   pVM             Pointer to the VM.
    904904 * @param   GCPtr           The virtual address the guest is writing to. (not correct if it's an alias!)
    905905 * @param   pvPtr           The HC mapping of that address.

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

    r39078 r41800  
    423423 * @returns VBox status code.
    424424 * @param   pNode           Current node
    425  * @param   pVM1            VM Handle
     425 * @param   pVM1            Pointer to the VM
    426426 */
    427427static DECLCALLBACK(int) patmSaveP2GLookupRecords(PAVLU32NODECORE pNode, void *pVM1)
    … …  
    445445 * @returns VBox status code.
    446446 * @param   pNode           Current node
    447  * @param   pVM1            VM Handle
     447 * @param   pVM1            Pointer to the VM
    448448 */
    449449static DECLCALLBACK(int) patmSaveFixupRecords(PAVLPVNODECORE pNode, void *pVM1)
    … …  
    581581 * @returns VBox status code.
    582582 * @param   pNode           Current node
    583  * @param   pVM1            VM Handle
     583 * @param   pVM1            Pointer to the VM
    584584 */
    585585static DECLCALLBACK(int) patmSavePatchState(PAVLOU32NODECORE pNode, void *pVM1)
    … …  
    632632 *
    633633 * @returns VBox status code.
    634  * @param   pVM             VM Handle.
     634 * @param   pVM             Pointer to the VM.
    635635 * @param   pSSM            SSM operation handle.
    636636 */
    … …  
    696696 *
    697697 * @returns VBox status code.
    698  * @param   pVM             VM Handle.
     698 * @param   pVM             Pointer to the VM.
    699699 * @param   pSSM            SSM operation handle.
    700700 * @param   uVersion        Data layout version.
    … …  
    972972 *
    973973 * @returns VBox status code.
    974  * @param   pVM             VM Handle.
     974 * @param   pVM             Pointer to the VM.
    975975 * @param   ulSSMVersion    SSM version
    976976 * @param   patmInfo        Saved PATM structure

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

    r41783 r41800  
    440440 * whenever the VMM need to relocate it self inside the GC.
    441441 *
    442  * @param   pVM         VM handle.
     442 * @param   pVM         Pointer to the VM.
    443443 * @param   offDelta    Relocation delta relative to old location.
    444444 * @remark  The loader subcomponent is relocated by PDMR3LdrRelocate() very
    … …  
    846846 *
    847847 * @returns VBox status code.
    848  * @param   pVM             VM Handle.
     848 * @param   pVM             Pointer to the VM.
    849849 * @param   pSSM            SSM operation handle.
    850850 * @param   uVersion        Data layout version.
    … …  
    10971097 * attached drivers about the VM now being powered on.
    10981098 *
    1099  * @param   pVM     VM Handle.
     1099 * @param   pVM     Pointer to the VM.
    11001100 */
    11011101VMMR3DECL(void) PDMR3PowerOn(PVM pVM)
    … …  
    14181418 * the VM now being reset.
    14191419 *
    1420  * @param   pVM     VM Handle.
     1420 * @param   pVM     Pointer to the VM.
    14211421 */
    14221422VMMR3DECL(void) PDMR3Reset(PVM pVM)
    … …  
    18091809 * attached drivers about the VM now being resumed.
    18101810 *
    1811  * @param   pVM     VM Handle.
     1811 * @param   pVM     Pointer to the VM.
    18121812 */
    18131813VMMR3DECL(void) PDMR3Resume(PVM pVM)
    … …  
    20102010 * attached drivers about the VM being powered off.
    20112011 *
    2012  * @param   pVM     VM Handle.
     2012 * @param   pVM     Pointer to the VM.
    20132013 */
    20142014VMMR3DECL(void) PDMR3PowerOff(PVM pVM)
    … …  
    20902090 *
    20912091 * @returns VBox status code.
    2092  * @param   pVM             VM handle.
     2092 * @param   pVM             Pointer to the VM.
    20932093 * @param   pszDevice       Device name.
    20942094 * @param   iInstance       Device instance.
    … …  
    21462146 *
    21472147 * @returns VBox status code.
    2148  * @param   pVM             VM Handle.
     2148 * @param   pVM             Pointer to the VM.
    21492149 * @param   pszDevice       Device name.
    21502150 * @param   iInstance       Device instance.
    … …  
    21792179 *
    21802180 * @returns VBox status code.
    2181  * @param   pVM             VM Handle.
     2181 * @param   pVM             Pointer to the VM.
    21822182 * @param   pszDevice       Device name.
    21832183 * @param   iInstance       Device instance.
    … …  
    22202220 *
    22212221 * @returns VBox status code.
    2222  * @param   pVM             VM Handle.
     2222 * @param   pVM             Pointer to the VM.
    22232223 * @param   pszDevice       Device name.
    22242224 * @param   iInstance       Device instance.
    … …  
    22652265 * Forced Action handler.
    22662266 *
    2267  * @param   pVM             VM handle.
     2267 * @param   pVM             Pointer to the VM.
    22682268 */
    22692269VMMR3DECL(void) PDMR3DmaRun(PVM pVM)
    … …  
    23012301 *
    23022302 * @returns VBox status code.
    2303  * @param   pVM             VM handle.
     2303 * @param   pVM             Pointer to the VM.
    23042304 * @param   GCPhys          The physical address.
    23052305 * @param   pvHeap          Ring-3 pointer.
    … …  
    23232323 *
    23242324 * @returns VBox status code.
    2325  * @param   pVM             VM handle.
     2325 * @param   pVM             Pointer to the VM.
    23262326 * @param   GCPhys          The physical address.
    23272327 */
    … …  
    23432343 *
    23442344 * @returns VBox status code.
    2345  * @param   pVM             VM handle.
     2345 * @param   pVM             Pointer to the VM.
    23462346 * @param   cbSize          Allocation size.
    23472347 * @param   pv              Ring-3 pointer. (out)
    … …  
    23692369 *
    23702370 * @returns VBox status code.
    2371  * @param   pVM             VM handle.
     2371 * @param   pVM             Pointer to the VM.
    23722372 * @param   pv              Ring-3 pointer.
    23732373 */

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

    r41783 r41800  
    159159 *
    160160 * @returns VBox status.
    161  * @param   pVM           VM handle.
     161 * @param   pVM           Pointer to the VM.
    162162 * @param   ppTemplate    Where to store the template handle.
    163163 */

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

    r41783 r41800  
    103103 *
    104104 * @returns VBox status code.
    105  * @param   pVM     VM Handle.
     105 * @param   pVM     Pointer to the VM.
    106106 */
    107107int pdmR3DevInit(PVM pVM)
    … …  
    583583 *
    584584 * @returns VBox status code.
    585  * @param   pVM             VM handle.
     585 * @param   pVM             Pointer to the VM.
    586586 * @param   pRegCB          The registration callback stuff.
    587587 * @param   pszFilename     Module filename.
    … …  
    724724 *
    725725 * @returns VBox status code.
    726  * @param   pVM             VM Handle.
     726 * @param   pVM             Pointer to the VM.
    727727 * @param   pszDevice       Device name.
    728728 * @param   iInstance       Device instance.
    … …  
    776776 *
    777777 * @returns VBox status code.
    778  * @param   pVM             VM Handle.
     778 * @param   pVM             Pointer to the VM.
    779779 * @param   pszDevice       Device name.
    780780 * @param   iInstance       Device instance.
    … …  
    835835 *
    836836 * @returns VBox status code.
    837  * @param   pVM             VM Handle.
     837 * @param   pVM             Pointer to the VM.
    838838 * @param   pszDevice       Device name.
    839839 * @param   iInstance       Device instance.
    … …  
    880880 *
    881881 * @returns VBox status code.
    882  * @param   pVM             VM Handle.
     882 * @param   pVM             Pointer to the VM.
    883883 * @param   pszDevice       Device name.
    884884 * @param   iInstance       Device instance.
    … …  
    962962 *
    963963 * @returns VBox status code.
    964  * @param   pVM             VM Handle.
     964 * @param   pVM             Pointer to the VM.
    965965 * @param   pszDevice       Device name.
    966966 * @param   iDevIns         Device instance.
    … …  
    10331033 *
    10341034 * @returns VBox status code.
    1035  * @param   pVM             VM Handle.
     1035 * @param   pVM             Pointer to the VM.
    10361036 * @param   pszDevice       Device name.
    10371037 * @param   iDevIns         Device instance.

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

    r41783 r41800  
    106106 *
    107107 * @returns VBox status code.
    108  * @param   pVM     VM Handle.
     108 * @param   pVM     Pointer to the VM.
    109109 */
    110110int pdmR3DrvInit(PVM pVM)
    … …  
    218218 *
    219219 * @returns VBox status code.
    220  * @param   pVM             VM handle.
     220 * @param   pVM             Pointer to the VM.
    221221 * @param   pRegCB          The registration callback stuff.
    222222 * @param   pszFilename     Module filename.

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

    r41783 r41800  
    708708 *
    709709 * @returns VBox status code.
    710  * @param   pVM             VM handle.
     710 * @param   pVM             Pointer to the VM.
    711711 * @param   pszModule       Module name.
    712712 * @param   pszSymbol       Symbol name. If it's value is less than 64k it's treated like a
    … …  
    762762 *
    763763 * @returns VBox status code.
    764  * @param   pVM             VM handle.
     764 * @param   pVM             Pointer to the VM.
    765765 * @param   pszModule       Module name. If NULL the main R0 module (VMMR0.r0) is assumes.
    766766 * @param   pszSymbol       Symbol name. If it's value is less than 64k it's treated like a
    … …  
    817817 *
    818818 * @returns VBox status code.
    819  * @param   pVM             VM handle.
     819 * @param   pVM             Pointer to the VM.
    820820 * @param   pszModule       Module name. If NULL the main R0 module (VMMR0.r0) is assumed.
    821821 * @param   pszSearchPath   List of directories to search if @a pszFile is
    … …  
    869869 *
    870870 * @returns VBox status code.
    871  * @param   pVM             VM handle.
     871 * @param   pVM             Pointer to the VM.
    872872 * @param   pszModule       Module name. If NULL the main R0 module (VMMGC.gc) is assumes.
    873873 * @param   pszSymbol       Symbol name. If it's value is less than 64k it's treated like a
    … …  
    932932 *
    933933 * @returns VBox status code.
    934  * @param   pVM             VM handle.
     934 * @param   pVM             Pointer to the VM.
    935935 * @param   pszModule       Module name. If NULL the main R0 module (VMMGC.gc) is assumes.
    936936 * @param   pszSearchPath   List of directories to search if @a pszFile is
    … …  
    12511251 * @returns VBox status code.
    12521252 *
    1253  * @param   pVM         VM handle
     1253 * @param   pVM         Pointer to the VM
    12541254 * @param   uPC         The program counter (eip/rip) to locate the module for.
    12551255 * @param   enmType     The module type.
    … …  
    13411341 * @returns VBox status code.
    13421342 *
    1343  * @param   pVM         VM handle
     1343 * @param   pVM         Pointer to the VM
    13441344 * @param   uPC         The program counter (eip/rip) to locate the module for.
    13451345 * @param   pszModName  Where to store the module name.
    … …  
    13851385 * @returns VBox status code.
    13861386 *
    1387  * @param   pVM         VM handle
     1387 * @param   pVM         Pointer to the VM
    13881388 * @param   uPC         The program counter (eip/rip) to locate the module for.
    13891389 * @param   pszModName  Where to store the module name.
    … …  
    14261426 *
    14271427 * @returns VBox status.
    1428  * @param   pVM             VM Handle.
     1428 * @param   pVM             Pointer to the VM.
    14291429 * @param   pfnCallback     Function to call back for each of the modules.
    14301430 * @param   pvArg           User argument.

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

    r41783 r41800  
    5050 *
    5151 * @returns VBox status.
    52  * @param   pVM                 VM handle.
     52 * @param   pVM                 Pointer to the VM.
    5353 * @param   cbItem              Item size.
    5454 * @param   cItems              Number of items.
    … …  
    193193 *
    194194 * @returns VBox status code.
    195  * @param   pVM                 VM handle.
     195 * @param   pVM                 Pointer to the VM.
    196196 * @param   pDevIns             Device instance.
    197197 * @param   cbItem              Size a queue item.
    … …  
    244244 *
    245245 * @returns VBox status code.
    246  * @param   pVM                 VM handle.
     246 * @param   pVM                 Pointer to the VM.
    247247 * @param   pDrvIns             Driver instance.
    248248 * @param   cbItem              Size a queue item.
    … …  
    294294 *
    295295 * @returns VBox status code.
    296  * @param   pVM                 VM handle.
     296 * @param   pVM                 Pointer to the VM.
    297297 * @param   cbItem              Size a queue item.
    298298 * @param   cItems              Number of items in the queue.
    … …  
    343343 *
    344344 * @returns VBox status code.
    345  * @param   pVM                 VM handle.
     345 * @param   pVM                 Pointer to the VM.
    346346 * @param   cbItem              Size a queue item.
    347347 * @param   cItems              Number of items in the queue.
    … …  
    494494 *
    495495 * @returns VBox status code.
    496  * @param   pVM         VM handle.
     496 * @param   pVM         Pointer to the VM.
    497497 * @param   pDevIns     Device instance.
    498498 * @thread  Emulation thread only.
    … …  
    546546 *
    547547 * @returns VBox status code.
    548  * @param   pVM         VM handle.
     548 * @param   pVM         Pointer to the VM.
    549549 * @param   pDrvIns     Driver instance.
    550550 * @thread  Emulation thread only.
    … …  
    652652 * This is a forced action callback.
    653653 *
    654  * @param   pVM     VM handle.
     654 * @param   pVM     Pointer to the VM.
    655655 * @thread  Emulation thread only.
    656656 */
    … …  
    883883 * This is called by for a single queue.
    884884 *
    885  * @param   pVM     VM handle.
     885 * @param   pVM     Pointer to the VM.
    886886 * @param   pTimer  Pointer to timer.
    887887 * @param   pvUser  Pointer to the queue.

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

    r41783 r41800  
    168168 *
    169169 * @returns VBox status code.
    170  * @param   pVM             VM handle.
     170 * @param   pVM             Pointer to the VM.
    171171 * @param   pRegCB          The registration callback stuff.
    172172 * @param   pszFilename     Module filename.

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

    r41783 r41800  
    15061506 *
    15071507 * @returns VBox status code.
    1508  * @param   pVM                 VM handle.
     1508 * @param   pVM                 Pointer to the VM.
    15091509 */
    15101510static int pgmR3InitPaging(PVM pVM)
    … …  
    20802080 *
    20812081 * @returns VBox status code.
    2082  * @param   pVM     VM handle.
     2082 * @param   pVM     Pointer to the VM.
    20832083 */
    20842084VMMR3DECL(int) PGMR3InitDynMap(PVM pVM)
    … …  
    25022502 * needs to be removed.
    25032503 *
    2504  * @param   pVM     VM handle.
     2504 * @param   pVM     Pointer to the VM.
    25052505 */
    25062506VMMR3DECL(void) PGMR3Reset(PVM pVM)
    … …  
    26282628 * Show paging mode.
    26292629 *
    2630  * @param   pVM         VM Handle.
     2630 * @param   pVM         Pointer to the VM.
    26312631 * @param   pHlp        The info helpers.
    26322632 * @param   pszArgs     "all" (default), "guest", "shadow" or "host".
    … …  
    26852685 * Dump registered MMIO ranges to the log.
    26862686 *
    2687  * @param   pVM         VM Handle.
     2687 * @param   pVM         Pointer to the VM.
    26882688 * @param   pHlp        The info helpers.
    26892689 * @param   pszArgs     Arguments, ignored.
    … …  
    27112711 * Dump the page directory to the log.
    27122712 *
    2713  * @param   pVM         VM Handle.
     2713 * @param   pVM         Pointer to the VM.
    27142714 * @param   pHlp        The info helpers.
    27152715 * @param   pszArgs     Arguments, ignored.
    … …  
    31383138 *
    31393139 * @returns The shadow paging mode.
    3140  * @param   pVM             VM handle.
     3140 * @param   pVM             Pointer to the VM.
    31413141 * @param   enmGuestMode    The guest mode.
    31423142 * @param   enmHostMode     The host mode.
    … …  
    33323332 *          will trigger using FFs and not status codes.
    33333333 *
    3334  * @param   pVM             VM handle.
     3334 * @param   pVM             Pointer to the VM.
    33353335 * @param   pVCpu           The VMCPU to operate on.
    33363336 * @param   enmGuestMode    The new guest mode. This is assumed to be different from

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

    r41783 r41800  
    115115 *
    116116 * @returns VBox status code.
    117  * @param   pVM         VM handle.
     117 * @param   pVM         Pointer to the VM.
    118118 * @param   pVCpu       The VMCPU to operate on.
    119119 * @param   GCPhysCR3   The physical address from the CR3 register.

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

    r40274 r41800  
    6969 *
    7070 * @returns VBox status code.
    71  * @param   pVM             VM handle.
     71 * @param   pVM             Pointer to the VM.
    7272 * @param   enmType         Handler type. Any of the PGMPHYSHANDLERTYPE_PHYSICAL* enums.
    7373 * @param   GCPhys          Start physical address.
    … …  
    137137 * Updates the physical page access handlers.
    138138 *
    139  * @param   pVM     VM handle.
     139 * @param   pVM     Pointer to the VM.
    140140 * @remark  Only used when restoring a saved state.
    141141 */
    … …  
    160160 * @returns 0
    161161 * @param   pNode   Pointer to a PGMPHYSHANDLER.
    162  * @param   pvUser  VM handle.
     162 * @param   pvUser  Pointer to the VM.
    163163 */
    164164static DECLCALLBACK(int) pgmR3HandlerPhysicalOneClear(PAVLROGCPHYSNODECORE pNode, void *pvUser)
    … …  
    190190 * @returns 0
    191191 * @param   pNode   Pointer to a PGMPHYSHANDLER.
    192  * @param   pvUser  VM handle.
     192 * @param   pvUser  Pointer to the VM.
    193193 */
    194194static DECLCALLBACK(int) pgmR3HandlerPhysicalOneSet(PAVLROGCPHYSNODECORE pNode, void *pvUser)
    … …  
    220220 *
    221221 * @returns VBox status code.
    222  * @param   pVM             VM handle.
     222 * @param   pVM             Pointer to the VM.
    223223 * @param   enmType         Handler type. Any of the PGMVIRTHANDLERTYPE_* enums.
    224224 * @param   GCPtr           Start address.
    … …  
    271271 *
    272272 * @returns VBox status code.
    273  * @param   pVM             VM handle.
     273 * @param   pVM             Pointer to the VM.
    274274 * @param   enmType         Handler type. Any of the PGMVIRTHANDLERTYPE_* enums.
    275275 * @param   GCPtr           Start address.
    … …  
    429429 *
    430430 * @returns VBox status code.
    431  * @param   pVM             VM handle.
     431 * @param   pVM             Pointer to the VM.
    432432 * @param   GCPtr           Start address.
    433433 * @param   pfnInvalidateR3 The R3 invalidate callback (can be 0)
    … …  
    453453 *
    454454 * @returns VBox status code.
    455  * @param   pVM         VM handle.
     455 * @param   pVM         Pointer to the VM.
    456456 * @param   GCPtr       Start address.
    457457 * @thread  EMT

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

    r35333 r41800  
    2323 * want to ignore those.
    2424 *
    25  * @param   pVM             VM Handle.
     25 * @param   pVM             Pointer to the VM.
    2626 * @param   GCPhys          Physical address start reading from.
    2727 */
    … …  
    4141 * want to ignore those.
    4242 *
    43  * @param   pVM             VM Handle.
     43 * @param   pVM             Pointer to the VM.
    4444 * @param   GCPhys          Physical address to write to.
    4545 * @param   val             What to write.

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

    r41783 r41800  
    543543 * @returns VINF_SUCCESS if the handler has carried out the operation.
    544544 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    545  * @param   pVM             VM Handle.
     545 * @param   pVM             Pointer to the VM.
    546546 * @param   GCPhys          The physical address the guest is writing to.
    547547 * @param   pvPhys          The HC mapping of that address.

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

    r41783 r41800  
    20392039 *
    20402040 * @returns VBox status code.
    2041  * @param   pVM             VM Handle.
     2041 * @param   pVM             Pointer to the VM.
    20422042 * @param   pSSM            SSM operation handle.
    20432043 */
    … …  
    21092109 *
    21102110 * @returns VBox status code.
    2111  * @param   pVM             VM Handle.
     2111 * @param   pVM             Pointer to the VM.
    21122112 * @param   pSSM            SSM operation handle.
    21132113 */
    … …  
    21432143 *
    21442144 * @returns VBox status code.
    2145  * @param   pVM             VM Handle.
     2145 * @param   pVM             Pointer to the VM.
    21462146 * @param   pSSM            SSM operation handle.
    21472147 */
    … …  
    30903090 *
    30913091 * @returns VBox status code.
    3092  * @param   pVM             VM Handle.
     3092 * @param   pVM             Pointer to the VM.
    30933093 * @param   pSSM            SSM operation handle.
    30943094 * @param   uVersion        Data layout version.

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

    r41783 r41800  
    5353 *
    5454 * @returns VBox status code.
    55  * @param   pVM                 VM handle.
     55 * @param   pVM                 Pointer to the VM.
    5656 * @param   enmGuestOS          Guest OS type.
    5757 * @param   pszModuleName       Module name.
    … …  
    135135 *
    136136 * @returns VBox status code.
    137  * @param   pVM                 VM handle.
     137 * @param   pVM                 Pointer to the VM.
    138138 * @param   pszModuleName       Module name.
    139139 * @param   pszVersion          Module version.
    … …  
    196196 *
    197197 * @returns VBox strict status code.
    198  * @param   pVM                 VM handle.
     198 * @param   pVM                 Pointer to the VM.
    199199 * @param   pVCpu               The VMCPU handle for the calling EMT.
    200200 * @param   pvUser              Pointer to a VMCPUID with the requester's ID.
    … …  
    244244 *
    245245 * @returns VBox status code.
    246  * @param   pVM                 VM handle
     246 * @param   pVM                 Pointer to the VM
    247247 */
    248248VMMR3DECL(int) PGMR3SharedModuleCheckAll(PVM pVM)
    … …  
    258258 *
    259259 * @returns VBox status code.
    260  * @param   pVM                 VM handle.
     260 * @param   pVM                 Pointer to the VM.
    261261 * @param   GCPtrPage           Page address.
    262262 * @param   pfShared            Shared status (out).

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

    r41783 r41800  
    528528 * needs to be removed.
    529529 *
    530  * @param   pVM     VM handle.
     530 * @param   pVM     Pointer to the VM.
    531531 */
    532532VMMR3DECL(void) SELMR3Reset(PVM pVM)
    … …  
    665665 *
    666666 * @returns VBox status code.
    667  * @param   pVM             VM Handle.
     667 * @param   pVM             Pointer to the VM.
    668668 * @param   pSSM            SSM operation handle.
    669669 */
    … …  
    692692 *
    693693 * @returns VBox status code.
    694  * @param   pVM             VM Handle.
     694 * @param   pVM             Pointer to the VM.
    695695 * @param   pSSM            SSM operation handle.
    696696 * @param   uVersion        Data layout version.
    … …  
    757757 *
    758758 * @returns VBox status code.
    759  * @param   pVM             VM Handle.
     759 * @param   pVM             Pointer to the VM.
    760760 * @param   pSSM            SSM operation handle.
    761761 */
    … …  
    13601360 * @returns VINF_SUCCESS if the handler have carried out the operation.
    13611361 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    1362  * @param   pVM             VM Handle.
     1362 * @param   pVM             Pointer to the VM.
    13631363 * @param   GCPtr           The virtual address the guest is writing to. (not correct if it's an alias!)
    13641364 * @param   pvPtr           The HC mapping of that address.
    … …  
    13881388 * @returns VINF_SUCCESS if the handler have carried out the operation.
    13891389 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    1390  * @param   pVM             VM Handle.
     1390 * @param   pVM             Pointer to the VM.
    13911391 * @param   GCPtr           The virtual address the guest is writing to. (not correct if it's an alias!)
    13921392 * @param   pvPtr           The HC mapping of that address.
    … …  
    14161416 * @returns VINF_SUCCESS if the handler have carried out the operation.
    14171417 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    1418  * @param   pVM             VM Handle.
     1418 * @param   pVM             Pointer to the VM.
    14191419 * @param   GCPtr           The virtual address the guest is writing to. (not correct if it's an alias!)
    14201420 * @param   pvPtr           The HC mapping of that address.
    … …  
    17921792 * @returns true if it matches.
    17931793 * @returns false and assertions on mismatch..
    1794  * @param   pVM     VM Handle.
     1794 * @param   pVM     Pointer to the VM.
    17951795 */
    17961796VMMR3DECL(bool) SELMR3CheckTSS(PVM pVM)
    … …  
    19351935 *
    19361936 * @returns VBox status.
    1937  * @param   pVM       VM Handle.
     1937 * @param   pVM       Pointer to the VM.
    19381938 * @param   SelLdt    LDT selector.
    19391939 * @param   ppvLdt    Where to store the flat address of LDT.
    … …  
    21732173 * @returns VBox status code, see SELMR3GetSelectorInfo for details.
    21742174 *
    2175  * @param   pVM         VM handle.
     2175 * @param   pVM         Pointer to the VM.
    21762176 * @param   pVCpu       VMCPU handle.
    21772177 * @param   Sel         The selector to get info about.
    … …  
    22992299 * @returns Other VBox status code on other errors.
    23002300 *
    2301  * @param   pVM         VM handle.
     2301 * @param   pVM         Pointer to the VM.
    23022302 * @param   pVCpu       The virtual CPU handle.
    23032303 * @param   Sel         The selector to get info about.
    … …  
    23292329 * @returns Other VBox status code on other errors.
    23302330 *
    2331  * @param   pVM         VM handle.
     2331 * @param   pVM         Pointer to the VM.
    23322332 * @param   Sel         The selector to get info about.
    23332333 * @param   pSelInfo    Where to store the information.
    … …  
    24922492 * Display the shadow gdt.
    24932493 *
    2494  * @param   pVM         VM Handle.
     2494 * @param   pVM         Pointer to the VM.
    24952495 * @param   pHlp        The info helpers.
    24962496 * @param   pszArgs     Arguments, ignored.
    … …  
    25262526 * Display the guest gdt.
    25272527 *
    2528  * @param   pVM         VM Handle.
     2528 * @param   pVM         Pointer to the VM.
    25292529 * @param   pHlp        The info helpers.
    25302530 * @param   pszArgs     Arguments, ignored.
    … …  
    25692569 * Display the shadow ldt.
    25702570 *
    2571  * @param   pVM         VM Handle.
     2571 * @param   pVM         Pointer to the VM.
    25722572 * @param   pHlp        The info helpers.
    25732573 * @param   pszArgs     Arguments, ignored.
    … …  
    25942594 * Display the guest ldt.
    25952595 *
    2596  * @param   pVM         VM Handle.
     2596 * @param   pVM         Pointer to the VM.
    25972597 * @param   pHlp        The info helpers.
    25982598 * @param   pszArgs     Arguments, ignored.
    … …  
    26492649 * Dumps the hypervisor GDT
    26502650 *
    2651  * @param   pVM     VM handle.
     2651 * @param   pVM     Pointer to the VM.
    26522652 */
    26532653VMMR3DECL(void) SELMR3DumpHyperGDT(PVM pVM)
    … …  
    26602660 * Dumps the hypervisor LDT
    26612661 *
    2662  * @param   pVM     VM handle.
     2662 * @param   pVM     Pointer to the VM.
    26632663 */
    26642664VMMR3DECL(void) SELMR3DumpHyperLDT(PVM pVM)
    … …  
    26712671 * Dumps the guest GDT
    26722672 *
    2673  * @param   pVM     VM handle.
     2673 * @param   pVM     Pointer to the VM.
    26742674 */
    26752675VMMR3DECL(void) SELMR3DumpGuestGDT(PVM pVM)
    … …  
    26822682 * Dumps the guest LDT
    26832683 *
    2684  * @param   pVM     VM handle.
     2684 * @param   pVM     Pointer to the VM.
    26852685 */
    26862686VMMR3DECL(void) SELMR3DumpGuestLDT(PVM pVM)

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

    r41783 r41800  
    77777777 * @returns NULL if not found.
    77787778 *
    7779  * @param   pVM             VM handle.
     7779 * @param   pVM             Pointer to the VM.
    77807780 * @param   pszName         Data unit name.
    77817781 * @param   uInstance       The data unit instance id.

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

    r41783 r41800  
    10351035 * check if this makes sense or not, but it seems like a good idea now....
    10361036 *
    1037  * @param   pVM     VM handle.
     1037 * @param   pVM     Pointer to the VM.
    10381038 */
    10391039VMM_INT_DECL(void) TMR3Reset(PVM pVM)
    … …  
    10851085 *
    10861086 * @returns VBox status
    1087  * @param   pVM             VM Handle.
     1087 * @param   pVM             Pointer to the VM.
    10881088 * @param   pszSymbol       Symbol to resolve.
    10891089 * @param   pRCPtrValue     Where to store the symbol value.
    … …  
    11051105 *
    11061106 * @returns VBox status code.
    1107  * @param   pVM             VM Handle.
     1107 * @param   pVM             Pointer to the VM.
    11081108 * @param   pSSM            SSM operation handle.
    11091109 */
    … …  
    11521152 *
    11531153 * @returns VBox status code.
    1154  * @param   pVM             VM Handle.
     1154 * @param   pVM             Pointer to the VM.
    11551155 * @param   pSSM            SSM operation handle.
    11561156 * @param   uVersion        Data layout version.
    … …  
    16721672 *
    16731673 * @returns VBox status.
    1674  * @param   pVM             VM handle.
     1674 * @param   pVM             Pointer to the VM.
    16751675 * @param   pDevIns         Device which timers should be destroyed.
    16761676 */
    … …  
    17051705 *
    17061706 * @returns VBox status.
    1707  * @param   pVM             VM handle.
     1707 * @param   pVM             Pointer to the VM.
    17081708 * @param   pUsbIns         USB device which timers should be destroyed.
    17091709 */
    … …  
    17381738 *
    17391739 * @returns VBox status.
    1740  * @param   pVM             VM handle.
     1740 * @param   pVM             Pointer to the VM.
    17411741 * @param   pDrvIns         Driver which timers should be destroyed.
    17421742 */
    … …  
    18401840 *
    18411841 * @param   pTimer      Timer handle.
    1842  * @param   pvUser      VM handle.
     1842 * @param   pvUser      Pointer to the VM.
    18431843 * @thread  Timer thread.
    18441844 *
    … …  
    29532953 * Display all timers.
    29542954 *
    2955  * @param   pVM         VM Handle.
     2955 * @param   pVM         Pointer to the VM.
    29562956 * @param   pHlp        The info helpers.
    29572957 * @param   pszArgs     Arguments, ignored.
    … …  
    29952995 * Display all active timers.
    29962996 *
    2997  * @param   pVM         VM Handle.
     2997 * @param   pVM         Pointer to the VM.
    29982998 * @param   pHlp        The info helpers.
    29992999 * @param   pszArgs     Arguments, ignored.
    … …  
    30423042 * Display all clocks.
    30433043 *
    3044  * @param   pVM         VM Handle.
     3044 * @param   pVM         Pointer to the VM.
    30453045 * @param   pHlp        The info helpers.
    30463046 * @param   pszArgs     Arguments, ignored.

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

    r41783 r41800  
    744744 * needs to be removed, any pending trap cleared, and the IDT reset.
    745745 *
    746  * @param   pVM     VM handle.
     746 * @param   pVM     Pointer to the VM.
    747747 */
    748748VMMR3DECL(void) TRPMR3Reset(PVM pVM)
    … …  
    785785 *
    786786 * @returns VBox status code.
    787  * @param   pVM             VM Handle.
     787 * @param   pVM             Pointer to the VM.
    788788 * @param   pSSM            SSM operation handle.
    789789 */
    … …  
    836836 *
    837837 * @returns VBox status code.
    838  * @param   pVM             VM Handle.
     838 * @param   pVM             Pointer to the VM.
    839839 * @param   pSSM            SSM operation handle.
    840840 * @param   uVersion        Data layout version.
    … …  
    11221122 * @returns VINF_SUCCESS if the handler have carried out the operation.
    11231123 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    1124  * @param   pVM             VM Handle.
     1124 * @param   pVM             Pointer to the VM.
    11251125 * @param   GCPtr           The virtual address the guest is writing to. (not correct if it's an alias!)
    11261126 * @param   pvPtr           The HC mapping of that address.
    … …  
    12081208 * @returns gate nr or ~0 is not found
    12091209 *
    1210  * @param   pVM         VM handle.
     1210 * @param   pVM         Pointer to the VM.
    12111211 * @param   GCPtr       GC address to check.
    12121212 */
    … …  
    13761376 * @returns True is gate handler, false if not.
    13771377 *
    1378  * @param   pVM         VM handle.
     1378 * @param   pVM         Pointer to the VM.
    13791379 * @param   GCPtr       GC address to check.
    13801380 */

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

    r41783 r41800  
    11741174 * This is used both on init and on runtime relocations.
    11751175 *
    1176  * @param   pVM         VM handle.
     1176 * @param   pVM         Pointer to the VM.
    11771177 * @param   offDelta    Relocation delta relative to old location.
    11781178 */
    … …  
    24852485 * in case of a creation failure.
    24862486 *
    2487  * @param   pVM             VM Handle.
     2487 * @param   pVM             Pointer to the VM.
    24882488 * @param   cMilliesEMTWait The number of milliseconds to wait for the emulation
    24892489 *                          threads.
    … …  
    30623062 *
    30633063 * @returns The current VM state.
    3064  * @param   pVM             VM handle.
     3064 * @param   pVM             Pointer to the VM.
    30653065 * @thread  Any
    30663066 */
    … …  
    33913391 * Sets the current VM state.
    33923392 *
    3393  * @param   pVM             VM handle.
     3393 * @param   pVM             Pointer to the VM.
    33943394 * @param   enmStateNew     The new state.
    33953395 * @param   enmStateOld     The old state (for asserting only).
    … …  
    35653565 *
    35663566 * @returns VBox status code.
    3567  * @param   pVM             VM handle.
     3567 * @param   pVM             Pointer to the VM.
    35683568 * @param   pfnAtState      Pointer to callback.
    35693569 * @param   pvUser          User argument.
    … …  
    36073607 *
    36083608 * @returns VBox status code.
    3609  * @param   pVM             VM handle.
     3609 * @param   pVM             Pointer to the VM.
    36103610 * @param   pfnAtState      Pointer to callback.
    36113611 * @param   pvUser          User argument.

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

    r41783 r41800  
    10401040 * @returns VINF_SUCCESS unless a fatal error occurred. In the latter
    10411041 *          case an appropriate status code is returned.
    1042  * @param   pVM         VM handle.
     1042 * @param   pVM         Pointer to the VM.
    10431043 * @param   pVCpu       VMCPU handle.
    10441044 * @param   fIgnoreInterrupts   If set the VM_FF_INTERRUPT flags is ignored.
    … …  
    11891189 *
    11901190 * @returns VBox strict status code.
    1191  * @param   pVM                 VM handle.
     1191 * @param   pVM                 Pointer to the VM.
    11921192 * @param   pVCpu               The VMCPU handle for the calling EMT.
    11931193 * @param   pvUser              The new g_aHaltMethods index.

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

    r41783 r41800  
    974974 *
    975975 * @returns VBox status code.
    976  * @param   pVM             VM Handle.
     976 * @param   pVM             Pointer to the VM.
    977977 * @param   pSSM            SSM operation handle.
    978978 */
    … …  
    996996 *
    997997 * @returns VBox status code.
    998  * @param   pVM             VM Handle.
     998 * @param   pVM             Pointer to the VM.
    999999 * @param   pSSM            SSM operation handle.
    10001000 * @param   uVersion        Data layout version.
    … …  
    10701070 *
    10711071 * @returns VBox status
    1072  * @param   pVM             VM Handle.
     1072 * @param   pVM             Pointer to the VM.
    10731073 * @param   pszSymbol       Symbol to resolv
    10741074 * @param   pRCPtrValue     Where to store the symbol value.
    … …  
    11961196 * Executes guest code in the raw-mode context.
    11971197 *
    1198  * @param   pVM         VM handle.
     1198 * @param   pVM         Pointer to the VM.
    11991199 * @param   pVCpu       The VMCPU to operate on.
    12001200 */
    … …  
    12651265 * Executes guest code (Intel VT-x and AMD-V).
    12661266 *
    1267  * @param   pVM         VM handle.
     1267 * @param   pVM         Pointer to the VM.
    12681268 * @param   pVCpu       The VMCPU to operate on.
    12691269 */
    … …  
    19841984 *
    19851985 * @returns VBox status code.
    1986  * @param   pVM         VM handle.
     1986 * @param   pVM         Pointer to the VM.
    19871987 * @param   pVCpu       VMCPU handle.
    19881988 */
    … …  
    20422042 *
    20432043 * @returns VBox status code.
    2044  * @param   pVM     VM handle.
     2044 * @param   pVM     Pointer to the VM.
    20452045 * @param   pVCpu   VMCPU handle
    20462046 * @remark  Careful with critsects.

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

    r39944 r41800  
    226226 * Dumps the VM state on a fatal error.
    227227 *
    228  * @param   pVM         VM Handle.
     228 * @param   pVM         Pointer to the VM.
    229229 * @param   pVCpu       VMCPU Handle.
    230230 * @param   rcErr       VBox status code.

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

    r41783 r41800  
    944944 *
    945945 * @returns VBox status code.
    946  * @param   pVM             VM handle.
     946 * @param   pVM             Pointer to the VM.
    947947 * @param   enmSwitcher     The new switcher.
    948948 * @remark  This function may be called before the VMM is initialized.
    … …  
    993993 *
    994994 * @returns VBox status code.
    995  * @param   pVM             VM handle.
     995 * @param   pVM             Pointer to the VM.
    996996 */
    997997VMMR3_INT_DECL(int) VMMR3DisableSwitcher(PVM pVM)
    … …  
    10131013 *
    10141014 * @returns host to guest ring 0 switcher entrypoint
    1015  * @param   pVM             VM handle.
     1015 * @param   pVM             Pointer to the VM.
    10161016 * @param   enmSwitcher     The new switcher.
    10171017 */

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

    r41783 r41800  
    478478 * @returns VBox status code.
    479479 *
    480  * @param   pVM             VM handle.
     480 * @param   pVM             Pointer to the VM.
    481481 * @param   ppReq           Where to store the pointer to the allocated packet.
    482482 * @param   enmType         Package type.
    … …  
    11071107 * @returns VBox status code.
    11081108 *
    1109  * @param   pVM         VM handle.
     1109 * @param   pVM         Pointer to the VM.
    11101110 * @param   pReq        Request packet to process.
    11111111 */

  • trunk/src/VBox/VMM/VMMRC/CSAMRC.cpp

    r40274 r41800  
    5454 *
    5555 * @returns VBox status code (appropriate for GC return).
    56  * @param   pVM         VM Handle.
     56 * @param   pVM         Pointer to the VM.
    5757 * @param   uErrorCode   CPU Error code.
    5858 * @param   pRegFrame   Trap register frame.

  • trunk/src/VBox/VMM/VMMRC/MMRamRC.cpp

    r41783 r41800  
    5252 * In other case it must be removed by MMGCRamDeregisterTrapHandler call.
    5353 *
    54  * @param   pVM         VM handle.
     54 * @param   pVM         Pointer to the VM.
    5555 */
    5656VMMRCDECL(void) MMGCRamRegisterTrapHandler(PVM pVM)
    … …  
    6464 * See description of MMGCRamRegisterTrapHandler call.
    6565 *
    66  * @param   pVM         VM handle.
     66 * @param   pVM         Pointer to the VM.
    6767 */
    6868VMMRCDECL(void) MMGCRamDeregisterTrapHandler(PVM pVM)

  • trunk/src/VBox/VMM/VMMRC/PATMRC.cpp

    r41799 r41800  
    4949 *
    5050 * @returns VBox status code (appropriate for trap handling and GC return).
    51  * @param   pVM         VM Handle.
     51 * @param   pVM         Pointer to the VM.
    5252 * @param   uErrorCode   CPU Error code.
    5353 * @param   pRegFrame   Trap register frame.

  • trunk/src/VBox/VMM/VMMRC/SELMRC.cpp

    r40450 r41800  
    4040 *
    4141 * @returns VBox status code (appropriate for trap handling and GC return).
    42  * @param   pVM         VM Handle.
     42 * @param   pVM         Pointer to the VM.
    4343 * @param   pRegFrame   Trap register frame.
    4444 * @param   iGDTEntry   The GDT entry to sync.
    … …  
    161161 *
    162162 * @returns VBox status code (appropriate for trap handling and GC return).
    163  * @param   pVM         VM Handle.
     163 * @param   pVM         Pointer to the VM.
    164164 * @param   uErrorCode  CPU Error code.
    165165 * @param   pRegFrame   Trap register frame.
    … …  
    236236 *
    237237 * @returns VBox status code (appropriate for trap handling and GC return).
    238  * @param   pVM         VM Handle.
     238 * @param   pVM         Pointer to the VM.
    239239 * @param   uErrorCode   CPU Error code.
    240240 * @param   pRegFrame   Trap register frame.
    … …  
    287287 *
    288288 * @returns VBox status code (appropriate for trap handling and GC return).
    289  * @param   pVM         VM Handle.
     289 * @param   pVM         Pointer to the VM.
    290290 * @param   uErrorCode  CPU Error code.
    291291 * @param   pRegFrame   Trap register frame.
    … …  
    422422 *
    423423 * @returns VBox status code (appropriate for trap handling and GC return).
    424  * @param   pVM         VM Handle.
     424 * @param   pVM         Pointer to the VM.
    425425 * @param   uErrorCode   CPU Error code.
    426426 * @param   pRegFrame   Trap register frame.
    … …  
    442442 *
    443443 * @returns VBox status code (appropriate for trap handling and GC return).
    444  * @param   pVM         VM Handle.
     444 * @param   pVM         Pointer to the VM.
    445445 * @param   uErrorCode   CPU Error code.
    446446 * @param   pRegFrame   Trap register frame.
    … …  
    463463 *
    464464 * @returns VBox status code (appropriate for trap handling and GC return).
    465  * @param   pVM         VM Handle.
     465 * @param   pVM         Pointer to the VM.
    466466 * @param   uErrorCode   CPU Error code.
    467467 * @param   pRegFrame   Trap register frame.

  • trunk/src/VBox/VMM/VMMRC/TRPMRC.cpp

    r41783 r41800  
    4747 *
    4848 * @returns VBox status.
    49  * @param   pVM         VM handle.
     49 * @param   pVM         Pointer to the VM.
    5050 * @param   iTrap       Trap number to install handler [0..255].
    5151 * @param   pfnHandler  Pointer to the handler. Use NULL for uninstalling the handler.
    … …  
    9595 *
    9696 * @returns VBox status code (appropriate for trap handling and GC return).
    97  * @param   pVM         VM Handle.
     97 * @param   pVM         Pointer to the VM.
    9898 * @param   uErrorCode   CPU Error code.
    9999 * @param   pRegFrame   Trap register frame.
    … …  
    158158 *
    159159 * @returns VBox status code (appropriate for trap handling and GC return).
    160  * @param   pVM         VM Handle.
     160 * @param   pVM         Pointer to the VM.
    161161 * @param   uErrorCode   CPU Error code.
    162162 * @param   pRegFrame   Trap register frame.

  • trunk/src/VBox/VMM/VMMRC/TRPMRCHandlers.cpp

    r41783 r41800  
    127127 * @returns rc, can be adjusted if its VINF_SUCCESS or something really bad
    128128 *          happened.
    129  * @param   pVM         VM handle.
     129 * @param   pVM         Pointer to the VM.
    130130 * @param   pVCpu       The virtual CPU handle.
    131131 * @param   rc          The VBox status code to return.

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

    r41783 r41800  
    344344 * @returns VBox status code (appropriate for GC return).
    345345 *          In this context RT_SUCCESS means to restart the instruction.
    346  * @param   pVM         VM handle.
     346 * @param   pVM         Pointer to the VM.
    347347 * @param   pRegFrame   Trap register frame.
    348348 */
    … …  
    365365 * @returns VBox status code (appropriate for GC return).
    366366 *          In this context RT_SUCCESS means to restart the instruction.
    367  * @param   pVM         VM handle.
     367 * @param   pVM         Pointer to the VM.
    368368 * @param   pRegFrame   Trap register frame.
    369369 */

  • trunk/src/VBox/VMM/include/PATMInternal.h

    r41760 r41800  
    681681 *
    682682 * @returns VBox status code (appropriate for trap handling and GC return).
    683  * @param   pVM         VM Handle.
     683 * @param   pVM         Pointer to the VM.
    684684 * @param   uErrorCode   CPU Error code.
    685685 * @param   pRegFrame   Trap register frame.

  • trunk/src/VBox/VMM/include/PGMInline.h

    r41783 r41800  
    14321432 * Locks a page to prevent flushing (important for cr3 root pages or shadow pae pd pages).
    14331433 *
    1434  * @param   pVM         VM Handle.
     1434 * @param   pVM         Pointer to the VM.
    14351435 * @param   pPage       PGM pool page
    14361436 */
    … …  
    14451445 * Unlocks a page to allow flushing again
    14461446 *
    1447  * @param   pVM         VM Handle.
     1447 * @param   pVM         Pointer to the VM.
    14481448 * @param   pPage       PGM pool page
    14491449 */
    … …  
    14791479 *
    14801480 * @returns boolean result
    1481  * @param   pVM         VM handle.
     1481 * @param   pVM         Pointer to the VM.
    14821482 */
    14831483DECL_FORCE_INLINE(bool) pgmMapAreMappingsEnabled(PVM pVM)

  • trunk/src/VBox/VMM/include/VMMSwitcher.h

    r35346 r41800  
    6868 * Callback function for relocating the core code belonging to a switcher.
    6969 *
    70  * @param   pVM         VM handle.
     70 * @param   pVM         Pointer to the VM.
    7171 * @param   pSwitcher   Pointer to the switcher structure.
    7272 * @param   R0PtrCode   Pointer to the first code byte in the ring-0 mapping.

  • trunk/src/VBox/VMM/testcase/tstAnimate.cpp

    r40274 r41800  
    327327 *
    328328 * @returns VBox status code.
    329  * @param   pVM     VM handle.
     329 * @param   pVM     Pointer to the VM.
    330330 */
    331331static DECLCALLBACK(int) cfgmR3CreateDefault(PVM pVM, void *pvUser)
Note: See TracChangeset for help on using the changeset viewer.

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