VirtualBox

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


Ignore:
Timestamp:
May 22, 2012 9:04:47 AM (13 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
78089
Message:

VMM/PGM: minor doxygen consistency.

Location:
trunk/src/VBox/VMM/VMMR3
Files:
2 edited

Legend:

Unmodified
Added
Removed

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

    r39402 r41386  
    4747 *
    4848 * @returns VBox status code.
    49  * @param   pVM             VM Handle.
     49 * @param   pVM             The VM handle.
    5050 * @param   GCPtr           Virtual Address. (Page table aligned!)
    5151 * @param   cb              Size of the range. Must be a 4MB aligned!
    … …  
    215215 *
    216216 * @returns VBox status code.
    217  * @param   pVM     VM Handle.
     217 * @param   pVM     The VM handle.
    218218 * @param   GCPtr   Virtual Address. (Page table aligned!)
    219219 *
    … …  
    289289 *
    290290 * @returns true/false.
    291  * @param   pVM         Pointer to the shared VM structure.
     291 * @param   pVM         The VM handle.
    292292 * @param   iPD         The first PDE in the range.
    293293 * @param   cPTs        The number of PDEs in the range.
    … …  
    313313 * The mapping *must* be in the list.
    314314 *
    315  * @param   pVM             Pointer to the shared VM structure.
     315 * @param   pVM             The VM handle.
    316316 * @param   pMapping        The mapping to unlink.
    317317 */
    … …  
    345345 * Links the mapping.
    346346 *
    347  * @param   pVM             Pointer to the shared VM structure.
     347 * @param   pVM             The VM handle.
    348348 * @param   pMapping        The mapping to linked.
    349349 */
    … …  
    392392 *
    393393 * @returns VBox status code.
    394  * @param   pVM     Pointer to the shared VM structure.
     394 * @param   pVM     The VM handle.
    395395 * @thread  EMT(0)
    396396 */
    … …  
    478478 *
    479479 * @returns VBox status code.
    480  * @param   pVM     The VM.
     480 * @param   pVM     The VM handle.
    481481 * @param   pcb     Where to store the size.
    482482 */
    … …  
    498498 *
    499499 * @returns VBox status code.
    500  * @param   pVM         The VM.
     500 * @param   pVM         The VM handle.
    501501 * @param   GCPtrBase   The address of the reserved range of guest memory.
    502502 * @param   cb          The size of the range starting at GCPtrBase.
    … …  
    538538 *
    539539 * @returns VBox status code.
    540  * @param   pVM         The VM.
     540 * @param   pVM         The VM handle.
    541541 * @param   GCPtrBase   The address of the reserved range of guest memory.
    542542 * @param   cb          The size of the range starting at GCPtrBase.
    … …  
    680680 *
    681681 * @returns VBox status code.
    682  * @param   pVM         The VM.
     682 * @param   pVM         The VM handle.
    683683 */
    684684VMMR3DECL(int) PGMR3MappingsDisable(PVM pVM)
    … …  
    721721 *
    722722 * @returns VBox status code.
    723  * @param   pVM         The VM.
     723 * @param   pVM         The VM handle.
    724724 */
    725725VMMR3DECL(int) PGMR3MappingsUnfix(PVM pVM)
    … …  
    766766 *
    767767 * @returns VBox status code.
    768  * @param   pVM         The virtual machine.
     768 * @param   pVM         The VM handle.
    769769 * @param   Addr        Intermediate context address of the mapping.
    770770 * @param   HCPhys      Start of the range of physical pages. This must be entriely below 4GB!
    … …  
    831831 *
    832832 * @returns VBox status code.
    833  * @param   pVM         VM handle.
    834  * @param   uAddress    Address of the mapping.
    835  * @param   cPages      Number of pages.
     833 * @param   pVM             The VM handle.
     834 * @param   uAddress        Address of the mapping.
     835 * @param   cPages          Number of pages.
    836836 * @param   pPTDefault      Pointer to the default page table for this mapping.
    837837 * @param   pPTPaeDefault   Pointer to the default page table for this mapping.
    … …  
    839839static int pgmR3MapIntermediateCheckOne(PVM pVM, uintptr_t uAddress, unsigned cPages, PX86PT pPTDefault, PX86PTPAE pPTPaeDefault)
    840840{
    841     AssertMsg((uAddress >> X86_PD_SHIFT) + cPages <= 1024, ("64-bit fixme\n"));
     841    AssertMsg((uAddress >> X86_PD_SHIFT) + cPages <= 1024, ("64-bit fixme uAddress=%RGv cPages=%u\n", uAddress, cPages));
    842842
    843843    /*
    … …  
    913913 * Sets up the intermediate page tables for a verified mapping.
    914914 *
    915  * @param   pVM             VM handle.
     915 * @param   pVM             The VM handle.
    916916 * @param   uAddress        Address of the mapping.
    917917 * @param   HCPhys          The physical address of the page range.
    … …  
    10641064 * Relocates a mapping to a new address.
    10651065 *
    1066  * @param   pVM                 VM handle.
     1066 * @param   pVM                 The VM handle.
    10671067 * @param   pMapping            The mapping to relocate.
    10681068 * @param   GCPtrOldMapping     The address of the start of the old mapping.
    … …  
    11861186 *
    11871187 * @returns VBox status code.
    1188  * @param   pVM                 VM Handle.
     1188 * @param   pVM                 The VM handle.
    11891189 * @param   pMapping            The mapping which conflicts.
    11901190 * @param   pPDSrc              The page directory of the guest OS.
    … …  
    12631263 *
    12641264 * @returns VBox status code.
    1265  * @param   pVM                 VM Handle.
     1265 * @param   pVM                 The VM handle.
    12661266 * @param   pMapping            The mapping which conflicts.
    12671267 * @param   GCPtrOldMapping     The address of the start of the current mapping.
    … …  
    13551355 *
    13561356 * @returns VBox status.
    1357  * @param   pVM         VM handle.
     1357 * @param   pVM         The VM handle.
    13581358 * @param   pvDst       The destination address (HC of course).
    13591359 * @param   GCPtrSrc    The source address (GC virtual address).

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

    r40274 r41386  
    102102 * @retval  VINF_SUCCESS.
    103103 *
    104  * @param   pVM             VM Handle.
     104 * @param   pVM             The VM handle.
    105105 * @param   GCPhys          Physical address to read from.
    106106 * @param   pvBuf           Where to read into.
    … …  
    231231 * @retval  VERR_EM_NO_MEMORY.
    232232 *
    233  * @param   pVM             VM Handle.
     233 * @param   pVM             The VM handle.
    234234 * @param   GCPhys          Physical address to write to.
    235235 * @param   pvBuf           What to write.
    … …  
    735735 * Called when anything was relocated.
    736736 *
    737  * @param   pVM         Pointer to the shared VM structure.
     737 * @param   pVM         The VM handle.
    738738 */
    739739void pgmR3PhysRelinkRamRanges(PVM pVM)
    … …  
    785785 * Links a new RAM range into the list.
    786786 *
    787  * @param   pVM         Pointer to the shared VM structure.
     787 * @param   pVM         The VM handle.
    788788 * @param   pNew        Pointer to the new list entry.
    789789 * @param   pPrev       Pointer to the previous list entry. If NULL, insert as head.
    … …  
    824824 * Unlink an existing RAM range from the list.
    825825 *
    826  * @param   pVM         Pointer to the shared VM structure.
     826 * @param   pVM         The VM handle.
    827827 * @param   pRam        Pointer to the new list entry.
    828828 * @param   pPrev       Pointer to the previous list entry. If NULL, insert as head.
    … …  
    860860 * Unlink an existing RAM range from the list.
    861861 *
    862  * @param   pVM         Pointer to the shared VM structure.
     862 * @param   pVM         The VM handle.
    863863 * @param   pRam        Pointer to the new list entry.
    864864 */
    … …  
    16181618 *
    16191619 * @returns VBox status code.
    1620  * @param   pVM             Pointer to the shared VM structure.
     1620 * @param   pVM             The VM handle.
    16211621 * @param   GCPhys          The physical address of the RAM.
    16221622 * @param   cb              The size of the RAM.
    … …  
    17551755 * @returns VBox status code.
    17561756 *
    1757  * @param   pVM     Pointer to the shared VM structure.
     1757 * @param   pVM     The VM handle.
    17581758 */
    17591759int pgmR3PhysRamPreAllocate(PVM pVM)
    … …  
    18221822 *
    18231823 * @returns VBox status code.
    1824  * @param   pVM     Pointer to the shared VM structure.
     1824 * @param   pVM     The VM handle.
    18251825 */
    18261826int pgmR3PhysRamReset(PVM pVM)
    … …  
    19841984 *
    19851985 * @returns VBox status code.
    1986  * @param   pVM     Pointer to the shared VM structure.
     1986 * @param   pVM     The VM handle.
    19871987 */
    19881988int pgmR3PhysRamTerm(PVM pVM)
    … …  
    20652065 * @returns VBox status code.
    20662066 *
    2067  * @param   pVM             Pointer to the shared VM structure.
     2067 * @param   pVM             The VM handle.
    20682068 * @param   GCPhys          The start of the MMIO region.
    20692069 * @param   cb              The size of the MMIO region.
    … …  
    22312231 *
    22322232 * @returns VBox status code.
    2233  * @param   pVM             Pointer to the shared VM structure.
     2233 * @param   pVM             The VM handle.
    22342234 * @param   GCPhys          The start of the MMIO region.
    22352235 * @param   cb              The size of the MMIO region.
    … …  
    23462346 *
    23472347 * @returns Pointer to the MMIO2 range.
    2348  * @param   pVM             Pointer to the shared VM structure.
     2348 * @param   pVM             The VM handle.
    23492349 * @param   pDevIns         The device instance owning the region.
    23502350 * @param   iRegion         The region.
    … …  
    23812381 * @retval  VERR_ALREADY_EXISTS if the region already exists.
    23822382 *
    2383  * @param   pVM             Pointer to the shared VM structure.
     2383 * @param   pVM             The VM handle.
    23842384 * @param   pDevIns         The device instance owning the region.
    23852385 * @param   iRegion         The region number.  If the MMIO2 memory is a PCI
    … …  
    25092509 *
    25102510 * @returns VBox status code.
    2511  * @param   pVM             Pointer to the shared VM structure.
     2511 * @param   pVM             The VM handle.
    25122512 * @param   pDevIns         The device instance owning the region.
    25132513 * @param   iRegion         The region. If it's UINT32_MAX it'll be a wildcard match.
    … …  
    26142614 * @returns VBox status code.
    26152615 *
    2616  * @param   pVM             Pointer to the shared VM structure.
    2617  * @param   pDevIns         The
     2616 * @param   pVM             The VM handle.
     2617 * @param   pDevIns         The device instance owning the region.
    26182618 */
    26192619VMMR3DECL(int) PGMR3PhysMMIO2Map(PVM pVM, PPDMDEVINS pDevIns, uint32_t iRegion, RTGCPHYS GCPhys)
    … …  
    28702870 *
    28712871 * @returns true/false accordingly.
    2872  * @param   pVM             Pointer to the shared VM structure.
     2872 * @param   pVM             The VM handle.
    28732873 * @param   pDevIns         The owner of the memory, optional.
    28742874 * @param   GCPhys          The address to check.
    … …  
    29082908 *
    29092909 * @returns VBox status code.
    2910  * @param   pVM             Pointer to the shared VM structure.
     2910 * @param   pVM             The VM handle.
    29112911 * @param   pDevIns         The owner of the memory, optional.
    29122912 * @param   iRegion         The region.
    … …  
    29432943 * @return VBox status code.
    29442944 *
    2945  * @param   pVM         Pointer to the shared VM structure.
     2945 * @param   pVM         The VM handle.
    29462946 * @param   pDevIns     The device owning the MMIO2 memory.
    29472947 * @param   iRegion     The region.
    … …  
    29852985 *
    29862986 * @returns VBox status.
    2987  * @param   pVM                 VM Handle.
     2987 * @param   pVM                 The VM handle.
    29882988 * @param   pDevIns             The device instance owning the ROM.
    29892989 * @param   GCPhys              First physical address in the range.
    … …  
    33483348 *
    33493349 * @returns VBox status.
    3350  * @param   pVM                 VM Handle.
     3350 * @param   pVM                 The VM handle.
    33513351 * @param   pDevIns             The device instance owning the ROM.
    33523352 * @param   GCPhys              First physical address in the range.
    … …  
    33823382 * @returns VINF_SUCCESS if the handler have carried out the operation.
    33833383 * @returns VINF_PGM_HANDLER_DO_DEFAULT if the caller should carry out the access operation.
    3384  * @param   pVM             VM Handle.
     3384 * @param   pVM             The VM handle.
    33853385 * @param   GCPhys          The physical address the guest is writing to.
    33863386 * @param   pvPhys          The HC mapping of that address.
    … …  
    36173617 * @retval  VINF_PGM_SYNC_CR3
    36183618 *
    3619  * @param   pVM         Pointer to the shared VM structure.
     3619 * @param   pVM         The VM handle.
    36203620 * @param   GCPhys      Where to start. Page aligned.
    36213621 * @param   cb          How much to change. Page aligned.
    … …  
    39433943 *
    39443944 * @returns VBox status code.
    3945  * @param   pVM         The VM to operate on.
     3945 * @param   pVM         The VM handle.
    39463946 */
    39473947void pgmR3PhysUnmapChunk(PVM pVM)
    … …  
    44084408 * This is used by ballooning, remapping MMIO2, RAM reset and state loading.
    44094409 *
    4410  * @param   pVM             Pointer to the shared VM structure.
     4410 * @param   pVM             The VM handle.
    44114411 * @param   pReq            Pointer to the request.
    44124412 * @param   pcPendingPages  Where the number of pages waiting to be freed are
Note: See TracChangeset for help on using the changeset viewer.

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