VirtualBox

Changeset 58124 in vbox


Ignore:
Timestamp:
Oct 8, 2015 6:30:55 PM (9 years ago)
Author:
vboxsync
Message:

include/VBox//*.h: pVM and pVCpu parameter description adjustments.

Location:
trunk
Files:
23 edited

Legend:

Unmodified
Added
Removed

  • trunk/include/VBox/ExtPack/ExtPack.h

    r56291 r58124  
    308308     * @param   pThis       Pointer to this structure.
    309309     * @param   pConsole    The console interface.
    310      * @param   pVM         The VM handle.
     310     * @param   pVM         The cross context VM structure.
    311311     */
    312312    DECLCALLBACKMEMBER(int, pfnVMConfigureVMM)(PCVBOXEXTPACKREG pThis, VBOXEXTPACK_IF_CS(IConsole) *pConsole, PVM pVM);
    … …  
    320320     * @param   pThis       Pointer to this structure.
    321321     * @param   pConsole    The console interface.
    322      * @param   pVM         The VM handle.
     322     * @param   pVM         The cross context VM structure.
    323323     */
    324324    DECLCALLBACKMEMBER(int, pfnVMPowerOn)(PCVBOXEXTPACKREG pThis, VBOXEXTPACK_IF_CS(IConsole) *pConsole, PVM pVM);
    … …  
    331331     * @param   pThis       Pointer to this structure.
    332332     * @param   pConsole    The console interface.
    333      * @param   pVM         The VM handle. Can be NULL.
     333     * @param   pVM         The cross context VM structure. Can be NULL.
    334334     */
    335335    DECLCALLBACKMEMBER(void, pfnVMPowerOff)(PCVBOXEXTPACKREG pThis, VBOXEXTPACK_IF_CS(IConsole) *pConsole, PVM pVM);

  • trunk/include/VBox/rawpci.h

    r56291 r58124  
    7878 * @returns VBox status code.
    7979 *
    80  * @param   pVM           VM pointer.
    81  * @param   HostStart     Physical address of region start on the host.
    82  * @param   GuestStart    Physical address of region start on the guest.
    83  * @param   cMemSize      Region size in bytes.
    84  * @param   Action        Action performed (i.e. if page was mapped or unmapped).
    85  */
    86 typedef DECLCALLBACK(int) FNRAWPCICONTIGPHYSMEMINFO(struct RAWPCIPERVM* pVmData, RTHCPHYS HostStart, RTGCPHYS GuestStart, uint64_t cMemSize, PCIRAWMEMINFOACTION Action);
     80 * @param   pVM             The cross context VM structure.
     81 * @param   HCPhysStart     Physical address of region start on the host.
     82 * @param   GCPhysStart     Physical address of region start on the guest.
     83 * @param   cbMem           Region size in bytes.
     84 * @param   enmAction       Action performed (i.e. if page was mapped
     85 *                          or unmapped).
     86 */
     87typedef DECLCALLBACK(int) FNRAWPCICONTIGPHYSMEMINFO(struct RAWPCIPERVM *pVmData, RTHCPHYS HCPhysStart,
     88                                                    RTGCPHYS GCPhysStart, uint64_t cbMem, PCIRAWMEMINFOACTION enmAction);
    8789typedef FNRAWPCICONTIGPHYSMEMINFO *PFNRAWPCICONTIGPHYSMEMINFO;
    8890
    … …  
    526528     * @returns VBox status code.
    527529     *
    528      * @param   pIfFactory          Pointer to this structure.
    529      * @param   pVM                 Pointer to VM structure to initialize.
    530      * @param   pPciData            Pointer to PCI data.
     530     * @param   pIfFactory  Pointer to this structure.
     531     * @param   pVM         The cross context VM structure.
     532     * @param   pPciData    Pointer to PCI data.
    531533     */
    532534    DECLR0CALLBACKMEMBER(int, pfnInitVm,(PRAWPCIFACTORY       pFactory,
    … …  
    539541     * @returns VBox status code.
    540542     *
    541      * @param   pIfFactory          Pointer to this structure.
    542      * @param   pVM                 Pointer to VM structure to deinitialize.
    543      * @param   pPciData            Pointer to PCI data.
     543     * @param   pIfFactory  Pointer to this structure.
     544     * @param   pVM         The cross context VM structure.
     545     * @param   pPciData    Pointer to PCI data.
    544546     */
    545547    DECLR0CALLBACKMEMBER(void, pfnDeinitVm,(PRAWPCIFACTORY       pFactory,

  • trunk/include/VBox/vmm/cfgm.h

    r58110 r58124  
    7575 *
    7676 * @returns VBox status code.
    77  * @param   pUVM            The user mode VM handle.
    78  * @param   pVM             The shared VM handle.
    79  * @param   pvUser          The argument supplied to VMR3Create().
     77 * @param   pUVM        The user mode VM handle.
     78 * @param   pVM         The cross context VM structure.
     79 * @param   pvUser      The argument supplied to VMR3Create().
    8080 */
    8181typedef DECLCALLBACK(int) FNCFGMCONSTRUCTOR(PUVM pUVM, PVM pVM, void *pvUser);

  • trunk/include/VBox/vmm/dbgf.h

    r58110 r58124  
    274274 *
    275275 * @returns VBox status code which must be propagated up to EM if not VINF_SUCCESS.
    276  * @param   pVM     VM Handle.
     276 * @param   pVCpu     The cross context VM structure.
    277277 */
    278278# ifdef VBOX_STRICT
    … …  
    495495 * Info handler, internal version.
    496496 *
    497  * @param   pVM         The VM handle.
     497 * @param   pVCpu         The cross context VM structure.
    498498 * @param   pHlp        Callback functions for doing output.
    499499 * @param   pszArgs     Argument string. Optional and specific to the handler.

  • trunk/include/VBox/vmm/em.h

    r58110 r58124  
    126126 * @returns true if enabled.
    127127 * @returns false if disabled.
    128  * @param   pVM         The VM to operate on.
     128 * @param   pVCpu         The cross context VM structure.
    129129 */
    130130#define EMIsRawRing3Enabled(pVM)            (!(pVM)->fRecompileUser)
    … …  
    135135 * @returns true if enabled.
    136136 * @returns false if disabled.
    137  * @param   pVM         The VM to operate on.
     137 * @param   pVCpu         The cross context VM structure.
    138138 */
    139139#define EMIsRawRing0Enabled(pVM)            (!(pVM)->fRecompileSupervisor)
    … …  
    145145 * @returns true if enabled.
    146146 * @returns false if disabled.
    147  * @param   pVM         The VM to operate on.
     147 * @param   pVCpu         The cross context VM structure.
    148148 */
    149149# define EMIsRawRing1Enabled(pVM)           ((pVM)->fRawRing1Enabled)
    … …  
    157157 * @returns true if enabled.
    158158 * @returns false if disabled.
    159  * @param   pVM         The VM to operate on.
     159 * @param   pVCpu         The cross context VM structure.
    160160 */
    161161#define EMIsHwVirtExecutionEnabled(pVM)     (!(pVM)->fRecompileSupervisor && !(pVM)->fRecompileUser)
    … …  
    167167 * @returns true if enabled.
    168168 * @returns false if disabled.
    169  * @param   pVM         The VM to operate on.
     169 * @param   pVCpu         The cross context VM structure.
    170170 */
    171171#define EMIsSupervisorCodeRecompiled(pVM) ((pVM)->fRecompileSupervisor)

  • trunk/include/VBox/vmm/gim.h

    r58110 r58124  
    104104 * A GIM Hypercall handler.
    105105 *
    106  * @param   pVM             Pointer to the VMCPU.
    107  * @param   pCtx            Pointer to the guest-CPU context.
     106 * @param   pVCpu   The cross context virtual CPU structure of the calling EMT.
     107 * @param   pCtx    Pointer to the guest-CPU context.
    108108 */
    109109typedef DECLCALLBACK(int) FNGIMHYPERCALL(PVMCPU pVCpu, PCPUMCTX pCtx);
    … …  
    115115 *
    116116 * @returns VBox status code.
    117  * @param   pVM             Pointer to the VMCPU.
    118  * @param   idMsr           The MSR being read.
    119  * @param   pRange          The range that the MSR belongs to.
    120  * @param   puValue         Where to store the value of the MSR.
     117 * @param   pVCpu   The cross context virtual CPU structure of the calling EMT.
     118 * @param   idMsr   The MSR being read.
     119 * @param   pRange  The range that the MSR belongs to.
     120 * @param   puValue Where to store the value of the MSR.
    121121 */
    122122typedef DECLCALLBACK(int) FNGIMRDMSR(PVMCPU pVCpu, uint32_t idMsr, PCCPUMMSRRANGE pRange, uint64_t *puValue);
    … …  
    128128 *
    129129 * @returns VBox status code.
    130  * @param   pVM             Pointer to the VMCPU.
    131  * @param   idMsr           The MSR being written.
    132  * @param   pRange          The range that the MSR belongs to.
    133  * @param   uValue          The value to set, ignored bits masked.
    134  * @param   uRawValue       The raw value with the ignored bits not masked.
     130 * @param   pVCpu       The cross context virtual CPU structure of the calling EMT.
     131 * @param   idMsr       The MSR being written.
     132 * @param   pRange      The range that the MSR belongs to.
     133 * @param   uValue      The value to set, ignored bits masked.
     134 * @param   uRawValue   The raw value with the ignored bits not masked.
    135135 */
    136136typedef DECLCALLBACK(int) FNGIMWRMSR(PVMCPU pVCpu, uint32_t idMsr, PCCPUMMSRRANGE pRange, uint64_t uValue, uint64_t uRawValue);

  • trunk/include/VBox/vmm/hm_vmx.h

    r58110 r58124  
    5757 * Sets a guest-state-updated flag.
    5858 *
    59  * @param   pVCpu   Pointer to the VMCPU.
     59 * @param   pVCpu   The cross context virtual CPU structure.
    6060 * @param   fFlag   The flag to set.
    6161 */
    … …  
    6565 * Checks if all the flags in the specified guest-state-updated set is pending.
    6666 *
    67  * @param   pVCpu   Pointer to the VMCPU.
     67 * @param   pVCpu   The cross context virtual CPU structure.
    6868 * @param   fFlag   The flag to check.
    6969 */
    … …  
    7474 * is updated.
    7575 *
    76  * @param   pVCpu   Pointer to the VMCPU.
     76 * @param   pVCpu   The cross context virtual CPU structure.
    7777 * @param   fFlags  The flags to check for.
    7878 */
    … …  
    8282 * Resets the guest-state-updated flags to the specified value.
    8383 *
    84  * @param   pVCpu   Pointer to the VMCPU.
     84 * @param   pVCpu   The cross context virtual CPU structure.
    8585 * @param   fFlags  The new value.
    8686 */
    … …  
    9090 * Returns the current guest-state-updated flags value.
    9191 *
    92  * @param   pVCpu   Pointer to the VMCPU.
     92 * @param   pVCpu   The cross context virtual CPU structure.
    9393 */
    9494#define HMVMXCPU_GST_VALUE(pVCpu)                     (ASMAtomicUoReadU32(&(pVCpu)->hm.s.vmx.fUpdatedGuestState))

  • trunk/include/VBox/vmm/pdmapi.h

    r58110 r58124  
    101101 *          Failure will stop the search and return the return code.
    102102 *          Warnings will be ignored and not returned.
    103  * @param   pVM             VM Handle.
     103 * @param   pVCpu             The cross context VM structure.
    104104 * @param   pszFilename     Module filename.
    105105 * @param   pszName         Module name. (short and unique)

  • trunk/include/VBox/vmm/pdmasynccompletion.h

    r58110 r58124  
    9696 * Completion callback for internal.
    9797 *
    98  * @param   pVM         Pointer to the shared VM structure.
     98 * @param   pVCpu         The cross context VM structure.
    9999 * @param   pvUser      User argument for the task.
    100100 * @param   pvUser2     User argument for the template.

  • trunk/include/VBox/vmm/pdmblkcache.h

    r58106 r58124  
    223223 *
    224224 * @returns VBox status code.
    225  * @param   pVM                      Pointer to the shared VM structure.
     225 * @param   pVCpu                      The cross context VM structure.
    226226 * @param   pDrvIns                  The driver instance.
    227227 * @param   ppBlkCache               Where to store the handle to the block cache.
    … …  
    241241 *
    242242 * @returns VBox status code.
    243  * @param   pVM                      Pointer to the shared VM structure.
     243 * @param   pVCpu                      The cross context VM structure.
    244244 * @param   pDevIns                  The device instance.
    245245 * @param   ppBlkCache               Where to store the handle to the block cache.
    … …  
    259259 *
    260260 * @returns VBox status code.
    261  * @param   pVM                      Pointer to the shared VM structure.
     261 * @param   pVCpu                      The cross context VM structure.
    262262 * @param   pUsbIns                  The USB device instance.
    263263 * @param   ppBlkCache               Where to store the handle to the block cache.
    … …  
    277277 *
    278278 * @returns VBox status code.
    279  * @param   pVM                      Pointer to the shared VM structure.
     279 * @param   pVCpu                      The cross context VM structure.
    280280 * @param   pvUser                   Opaque user data.
    281281 * @param   ppBlkCache               Where to store the handle to the block cache.
    … …  
    303303 *
    304304 * @returns nothing.
    305  * @param   pVM             Pointer to the shared VM structure.
     305 * @param   pVCpu             The cross context VM structure.
    306306 * @param   pDevIns         The device instance.
    307307 */
    … …  
    312312 *
    313313 * @returns nothing.
    314  * @param   pVM             Pointer to the shared VM structure.
     314 * @param   pVCpu             The cross context VM structure.
    315315 * @param   pDrvIns         The driver instance.
    316316 */
    … …  
    321321 *
    322322 * @returns nothing.
    323  * @param   pVM             Pointer to the shared VM structure.
     323 * @param   pVCpu             The cross context VM structure.
    324324 * @param   pUsbIns         The USB device instance.
    325325 */

  • trunk/include/VBox/vmm/pdmqueue.h

    r56291 r58124  
    107107 * @returns Success indicator.
    108108 *          If false the item will not be removed and the flushing will stop.
    109  * @param   pVM         The VM handle.
     109 * @param   pVCpu         The cross context VM structure.
    110110 * @param   pItem       The item to consume. Upon return this item will be freed.
    111111 * @remarks No locks will be held, but for now it's safe to assume that only one

  • trunk/include/VBox/vmm/pdmsrv.h

    r56291 r58124  
    208208     *
    209209     * @returns VBox status.
    210      * @param   pVM             The VM to create the timer in.
     210     * @param   pVCpu             The cross context VM structure.
    211211     * @param   pSrvIns         Service instance.
    212212     * @param   enmClock        The clock to use on this timer.

  • trunk/include/VBox/vmm/pdmthread.h

    r57393 r58124  
    121121 *
    122122 * @returns VBox status code.
    123  * @param   pVM         The VM handle.
     123 * @param   pVCpu         The cross context VM structure.
    124124 * @param   pThread     The PDM thread data.
    125125 */
    … …  
    177177 *
    178178 * @returns VBox status code.
    179  * @param   pVM         The VM handle.
     179 * @param   pVCpu         The cross context VM structure.
    180180 * @param   pThread     The PDM thread data.
    181181 */

  • trunk/include/VBox/vmm/pgm.h

    r58110 r58124  
    168168 *
    169169 * @returns Strict VBox status code (appropriate for ring-0 and raw-mode).
    170  * @param   pVM         VM Handle.
    171  * @param   pVCpu           Pointer to the cross context CPU context for the
    172  *                          calling EMT.
     170 * @param   pVCpu         The cross context VM structure.
     171 * @param   pVCpu       The cross context virtual CPU structure of the calling EMT.
    173172 * @param   uErrorCode  CPU Error code.
    174173 * @param   pRegFrame   Trap register frame.
    … …  
    199198 * @retval  VINF_EM_XXX in ring-0 and raw-mode context.
    200199 *
    201  * @param   pVM             VM Handle.
    202  * @param   pVCpu           Pointer to the cross context CPU context for the
    203  *                          calling EMT.
     200 * @param   pVCpu             The cross context VM structure.
     201 * @param   pVCpu           The cross context virtual CPU structure of the calling EMT.
    204202 * @param   GCPhys          The physical address the guest is writing to.
    205203 * @param   pvPhys          The HC mapping of that address.
    … …  
    239237 *
    240238 * @returns Strict VBox status code (appropriate for raw-mode).
    241  * @param   pVM             VM Handle.
    242  * @param   pVCpu           Pointer to the cross context CPU context for the
    243  *                          calling EMT.
     239 * @param   pVCpu             The cross context VM structure.
     240 * @param   pVCpu           The cross context virtual CPU structure of the calling EMT.
    244241 * @param   uErrorCode      CPU Error code (X86_TRAP_PF_XXX).
    245242 * @param   pRegFrame       Trap register frame.
    … …  
    264261 * @returns VINF_SUCCESS if the handler have carried out the operation.
    265262 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    266  * @param   pVM             VM Handle.
    267  * @param   pVCpu           Pointer to the cross context CPU context for the
    268  *                          calling EMT.
     263 * @param   pVCpu             The cross context VM structure.
     264 * @param   pVCpu           The cross context virtual CPU structure of the calling EMT.
    269265 * @param   GCPtr           The virtual address the guest is writing to.  This
    270266 *                          is the registered address corresponding to the
    … …  
    286282 * \#PF Handler callback for invalidation of virtual access handler ranges.
    287283 *
    288  * @param   pVM             VM Handle.
    289  * @param   pVCpu           Pointer to the cross context CPU context for the
    290  *                          calling EMT.
     284 * @param   pVCpu             The cross context VM structure.
     285 * @param   pVCpu           The cross context virtual CPU structure of the calling EMT.
    291286 * @param   GCPtr           The virtual address the guest has changed.
    292287 * @param   pvUser          User argument.
    … …  
    305300 * PGMR3PhysEnumDirtyFTPages callback for syncing dirty physical pages
    306301 *
    307  * @param   pVM             VM Handle.
     302 * @param   pVCpu             The cross context VM structure.
    308303 * @param   GCPhys          GC physical address
    309304 * @param   pRange          HC virtual address of the page(s)
    … …  
    636631 *
    637632 * @returns 0 - disabled, 1 - enabled
    638  * @param   pVM         The VM to operate on.
     633 * @param   pVCpu         The cross context VM structure.
    639634 */
    640635#define PGMIsUsingLargePages(pVM)   ((pVM)->fUseLargePages)

  • trunk/include/VBox/vmm/ssm.h

    r58110 r58124  
    815815 *
    816816 * @returns VBox status code.
    817  * @param   pVM             VM Handle.
     817 * @param   pVCpu             The cross context VM structure.
    818818 * @param   pSSM            SSM operation handle.
    819819 * @thread  Any.
    … …  
    830830 *
    831831 * @returns VBox status code.
    832  * @param   pVM             VM Handle.
     832 * @param   pVCpu             The cross context VM structure.
    833833 * @param   pSSM            SSM operation handle.
    834834 * @param   uPass           The data pass.
    … …  
    852852 * @retval  VERR_SSM_VOTE_FOR_GIVING_UP if its time to give up.
    853853 *
    854  * @param   pVM             VM Handle.
     854 * @param   pVCpu             The cross context VM structure.
    855855 * @param   pSSM            SSM operation handle.
    856856 * @param   uPass           The data pass.
    … …  
    865865 *
    866866 * @returns VBox status code.
    867  * @param   pVM             VM Handle.
     867 * @param   pVCpu             The cross context VM structure.
    868868 * @param   pSSM            SSM operation handle.
    869869 */
    … …  
    876876 *
    877877 * @returns VBox status code.
    878  * @param   pVM             VM Handle.
     878 * @param   pVCpu             The cross context VM structure.
    879879 * @param   pSSM            SSM operation handle.
    880880 */
    … …  
    887887 *
    888888 * @returns VBox status code.
    889  * @param   pVM             VM Handle.
     889 * @param   pVCpu             The cross context VM structure.
    890890 * @param   pSSM            SSM operation handle.
    891891 */
    … …  
    898898 *
    899899 * @returns VBox status code.
    900  * @param   pVM             VM Handle.
     900 * @param   pVCpu             The cross context VM structure.
    901901 * @param   pSSM            SSM operation handle.
    902902 */
    … …  
    909909 *
    910910 * @returns VBox status code.
    911  * @param   pVM             VM Handle.
     911 * @param   pVCpu             The cross context VM structure.
    912912 * @param   pSSM            SSM operation handle.
    913913 * @param   uVersion        Data layout version.
    … …  
    923923 *
    924924 * @returns VBox load code.
    925  * @param   pVM             VM Handle.
     925 * @param   pVCpu             The cross context VM structure.
    926926 * @param   pSSM            SSM operation handle.
    927927 */

  • trunk/include/VBox/vmm/stam.h

    r58110 r58124  
    11131113 * Registers a statistics sample.
    11141114 *
    1115  * @param   pVM         VM Handle.
     1115 * @param   pVCpu         The cross context VM structure.
    11161116 * @param   pvSample    Pointer to the sample.
    11171117 * @param   enmType     Sample type. This indicates what pvSample is pointing at.
    … …  
    11271127 * Registers a statistics sample if statistics are enabled.
    11281128 *
    1129  * @param   pVM         VM Handle.
     1129 * @param   pVCpu         The cross context VM structure.
    11301130 * @param   pvSample    Pointer to the sample.
    11311131 * @param   enmType     Sample type. This indicates what pvSample is pointing at.
    … …  
    11411141 * Registers a statistics sample which only shows when used.
    11421142 *
    1143  * @param   pVM         VM Handle.
     1143 * @param   pVCpu         The cross context VM structure.
    11441144 * @param   pvSample    Pointer to the sample.
    11451145 * @param   enmType     Sample type. This indicates what pvSample is pointing at.
    … …  
    11551155 * Registers a statistics sample which only shows when used, if statistics are enabled.
    11561156 *
    1157  * @param   pVM         VM Handle.
     1157 * @param   pVCpu         The cross context VM structure.
    11581158 * @param   pvSample    Pointer to the sample.
    11591159 * @param   enmType     Sample type. This indicates what pvSample is pointing at.
    … …  
    11771177/**
    11781178 * Resets the sample.
    1179  * @param   pVM         The VM handle.
     1179 * @param   pVCpu         The cross context VM structure.
    11801180 * @param   pvSample    The sample registered using STAMR3RegisterCallback.
    11811181 */
    … …  
    11871187 * Prints the sample into the buffer.
    11881188 *
    1189  * @param   pVM         The VM handle.
     1189 * @param   pVCpu         The cross context VM structure.
    11901190 * @param   pvSample    The sample registered using STAMR3RegisterCallback.
    11911191 * @param   pszBuf      The buffer to print into.

  • trunk/include/VBox/vmm/tm.h

    r58110 r58124  
    195195 * Internal timer callback function.
    196196 *
    197  * @param   pVM             The VM.
     197 * @param   pVCpu             The cross context VM structure.
    198198 * @param   pTimer          The timer handle.
    199199 * @param   pvUser          User argument specified upon timer creation.

  • trunk/include/VBox/vmm/trpm.h

    r58110 r58124  
    125125 * @returns VBox status code (appropriate for GC return).
    126126 *          In this context VINF_SUCCESS means to restart the instruction.
    127  * @param   pVM         VM handle.
     127 * @param   pVCpu         The cross context VM structure.
    128128 * @param   pRegFrame   Trap register frame.
    129129 */

  • trunk/include/VBox/vmm/vm.h

    r58110 r58124  
    515515 * Sets a force action flag.
    516516 *
    517  * @param   pVM     Pointer to the VM.
     517 * @param   pVCpu     The cross context VM structure.
    518518 * @param   fFlag   The flag to set.
    519519 */
    … …  
    530530 * Sets a force action flag for the given VCPU.
    531531 *
    532  * @param   pVCpu   Pointer to the VMCPU.
     532 * @param   pVCpu   The cross context virtual CPU structure.
    533533 * @param   fFlag   The flag to set.
    534534 */
    … …  
    538538 * Clears a force action flag.
    539539 *
    540  * @param   pVM     Pointer to the VM.
     540 * @param   pVCpu     The cross context VM structure.
    541541 * @param   fFlag   The flag to clear.
    542542 */
    … …  
    553553 * Clears a force action flag for the given VCPU.
    554554 *
    555  * @param   pVCpu   Pointer to the VMCPU.
     555 * @param   pVCpu   The cross context virtual CPU structure.
    556556 * @param   fFlag   The flag to clear.
    557557 */
    … …  
    561561 * Checks if a force action flag is set.
    562562 *
    563  * @param   pVM     Pointer to the VM.
     563 * @param   pVCpu     The cross context VM structure.
    564564 * @param   fFlag   The flag to check.
    565565 */
    … …  
    569569 * Checks if a force action flag is set for the given VCPU.
    570570 *
    571  * @param   pVCpu   Pointer to the VMCPU.
     571 * @param   pVCpu   The cross context virtual CPU structure.
    572572 * @param   fFlag   The flag to check.
    573573 */
    … …  
    577577 * Checks if one or more force action in the specified set is pending.
    578578 *
    579  * @param   pVM     Pointer to the VM.
     579 * @param   pVCpu     The cross context VM structure.
    580580 * @param   fFlags  The flags to check for.
    581581 */
    … …  
    587587 * @returns true if the bit was set.
    588588 * @returns false if the bit was clear.
    589  * @param   pVM     Pointer to the VM.
     589 * @param   pVCpu     The cross context VM structure.
    590590 * @param   iBit    Bit position to check and clear
    591591 */
    … …  
    597597 * @returns true if the bit was set.
    598598 * @returns false if the bit was clear.
    599  * @param   pVCpu   Pointer to the VMCPU.
     599 * @param   pVCpu   The cross context virtual CPU structure.
    600600 * @param   iBit    Bit position to check and clear
    601601 */
    … …  
    605605 * Checks if one or more force action in the specified set is pending for the given VCPU.
    606606 *
    607  * @param   pVCpu   Pointer to the VMCPU.
     607 * @param   pVCpu   The cross context virtual CPU structure.
    608608 * @param   fFlags  The flags to check for.
    609609 */
    … …  
    614614 * or more other ones are not.
    615615 *
    616  * @param   pVM     Pointer to the VM.
     616 * @param   pVCpu     The cross context VM structure.
    617617 * @param   fFlags  The flags to check for.
    618618 * @param   fExcpt  The flags that should not be set.
    … …  
    624624 * VCPU while one or more other ones are not.
    625625 *
    626  * @param   pVCpu   Pointer to the VMCPU.
     626 * @param   pVCpu   The cross context virtual CPU structure.
    627627 * @param   fFlags  The flags to check for.
    628628 * @param   fExcpt  The flags that should not be set.

  • trunk/include/VBox/vmm/vmapi.h

    r58110 r58124  
    4444 *
    4545 * @returns raw-mode virtual address.
    46  * @param   pVM     Pointer to the VM.
     46 * @param   pVCpu     The cross context VM structure.
    4747 * @param   pvInVM  CC Pointer within the VM.
    4848 */
    … …  
    6060 *
    6161 * @returns host virtual address.
    62  * @param   pVM     Pointer to the VM.
     62 * @param   pVCpu     The cross context VM structure.
    6363 * @param   pvInVM  CC pointer within the VM.
    6464 */
    … …  
    7777 *
    7878 * @returns host virtual address.
    79  * @param   pVM     Pointer to the VM.
     79 * @param   pVCpu     The cross context VM structure.
    8080 * @param   pvInVM  CC pointer within the VM.
    8181 */
    … …  
    116116 *    return VM_SET_ERROR(pVM, VERR_OF_YOUR_CHOICE, "descriptive message");
    117117 *    @endcode
    118  * @param   pVM             VM handle.
     118 * @param   pVCpu             The cross context VM structure.
    119119 * @param   rc              VBox status code.
    120120 * @param   pszMessage      Error message string.
    … …  
    131131 *    return VM_SET_ERROR(pVM, VERR_OF_YOUR_CHOICE, "descriptive message");
    132132 *    @endcode
    133  * @param   pVM             VM handle.
     133 * @param   pVCpu             The cross context VM structure.
    134134 * @param   rc              VBox status code.
    135135 * @param   pszMessage      Error message string.

  • trunk/include/VBox/vmm/vmm.h

    r58110 r58124  
    130130 *
    131131 * @returns VBox status code.
    132  * @param   pVCpu           Pointer to the VMCPU.
     132 * @param   pVCpu           The cross context virtual CPU structure.
    133133 * @param   enmOperation    The operation causing the ring-3 jump.
    134134 * @param   pvUser          The user argument.
    … …  
    145145 *          scheduling.
    146146 *
    147  * @param   pVM         The VM handle.
    148  * @param   pVCpu       The handle of the calling virtual CPU.
    149  * @param   pvUser      The user argument.
     147 * @param   pVCpu     The cross context VM structure.
     148 * @param   pVCpu   The cross context virtual CPU structure of the calling EMT.
     149 * @param   pvUser  The user argument.
    150150 */
    151151typedef DECLCALLBACK(VBOXSTRICTRC) FNVMMEMTRENDEZVOUS(PVM pVM, PVMCPU pVCpu, void *pvUser);

  • trunk/include/VBox/vusb.h

    r58106 r58124  
    854854     *                          reset  is preformed not respecting the 10ms.
    855855     * @param   pvUser          User argument to the completion routine.
    856      * @param   pVM             Pointer to the VM handle if callback in EMT is required. (optional)
     856     * @param   pVM             The cross context VM structure.  Required if pfnDone
     857     *                          is not NULL.
    857858     */
    858859    DECLR3CALLBACKMEMBER(int, pfnReset,(PVUSBIDEVICE pInterface, bool fResetOnLinux,
    … …  
    926927 * @param   fResetOnLinux   Set if we can permit a real reset and a potential logical
    927928 *                          device reconnect on linux hosts.
    928  * @param   pfnDone         Pointer to the completion routine. If NULL a synchronous
    929  *                          reset  is preformed not respecting the 10ms.
     929 * @param   pfnDone         Pointer to the completion routine.  If NULL a
     930 *                          synchronous reset is preformed not respecting the
     931 *                          10ms.
    930932 * @param   pvUser          User argument to the completion routine.
    931  * @param   pVM             Pointer to the VM handle if callback in EMT is required. (optional)
     933 * @param   pVM             The cross context VM structure.  Required if pfnDone
     934 *                          is not NULL.
     935 *
     936 * NULL is acceptable Required if callback in EMT is desired, NULL is otherwise
     937 *                          acceptable.
    932938 */
    933939DECLINLINE(int) VUSBIDevReset(PVUSBIDEVICE pInterface, bool fResetOnLinux, PFNVUSBRESETDONE pfnDone, void *pvUser, PVM pVM)

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

    r58123 r58124  
    531531
    532532/**
    533  * Updates the VM's last error record. If there was a VMX instruction error,
    534  * reads the error data from the VMCS and updates VCPU's last error record as
    535  * well.
     533 * Updates the VM's last error record.
     534 *
     535 * If there was a VMX instruction error, reads the error data from the VMCS and
     536 * updates VCPU's last error record as well.
    536537 *
    537538 * @param   pVM     The cross context VM structure.
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