VirtualBox

Changeset 62984 in vbox for trunk/include


Ignore:
Timestamp:
Aug 4, 2016 1:01:32 PM (8 years ago)
Author:
vboxsync
Message:

DrvPciRaw.cpp/PDMIPCIRAWUP: warnings and adjustments.

File:
1 edited

Legend:

Unmodified
Added
Removed

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

    r62476 r62984  
    5252     * @thread  Any thread.
    5353     */
    54     DECLR3CALLBACKMEMBER(int, pfnInterruptRequest ,(PPDMIPCIRAW pInterface, int32_t iGuestIrq));
     54    DECLR3CALLBACKMEMBER(int, pfnInterruptRequest,(PPDMIPCIRAW pInterface, int32_t iGuestIrq));
    5555} PDMIPCIRAW;
    5656
    … …  
    6868     * @param   pInterface          Pointer to this interface structure.
    6969     * @param   iRegion             Region number.
    70      * @param   pRegStart           Where to store region base address (guest).
    71      * @param   piRegSize           Where to store region size.
     70     * @param   pGCPhysRegion       Where to store region base address (guest).
     71     * @param   pcbRegion           Where to store region size.
    7272     *
    7373     * @param   fMmio               If region is MMIO or IO.
    … …  
    7575     */
    7676    DECLR3CALLBACKMEMBER(bool, pfnGetRegionInfo, (PPDMIPCIRAWUP pInterface,
    77                                                   int32_t              iRegion,
    78                                                   RTGCPHYS             *pRegStart,
    79                                                   uint64_t             *piRegSize,
    80                                                   uint32_t             *pfFlags
    81                                                   ));
     77                                                  uint32_t      iRegion,
     78                                                  RTGCPHYS     *pGCPhysRegion,
     79                                                  uint64_t     *pcbRegion,
     80                                                  uint32_t     *pfFlags));
    8281
    8382    /**
    … …  
    9190     * @param   iRegion             Number of the region.
    9291     * @param   StartAddress        Host physical address of start.
    93      * @param   iRegionSize         Size of the region.
     92     * @param   cbRegion            Size of the region.
    9493     * @param   fFlags              Flags, currently lowest significant bit set if R0 mapping requested too
    9594     * @param   ppvAddressR3        Where to store mapped region address for R3 (can be 0, if cannot map into userland)
    … …  
    9998     */
    10099    DECLR3CALLBACKMEMBER(int, pfnMapRegion, (PPDMIPCIRAWUP pInterface,
    101                                              int32_t              iRegion,
    102                                              RTHCPHYS             StartAddress,
    103                                              uint64_t             iRegionSize,
    104                                              uint32_t             fFlags,
    105                                              RTR3PTR              *ppvAddressR3,
    106                                              RTR0PTR              *ppvAddressR0
    107                                              ));
     100                                             uint32_t      iRegion,
     101                                             RTHCPHYS      StartAddress,
     102                                             uint64_t      cbRegion,
     103                                             uint32_t      fFlags,
     104                                             PRTR3PTR      ppvAddressR3,
     105                                             PRTR0PTR      ppvAddressR0));
    108106
    109107    /**
    … …  
    115113     * @param   iRegion             Number of the region.
    116114     * @param   StartAddress        Host physical address of start.
    117      * @param   iRegionSize         Size of the region.
     115     * @param   cbRegion            Size of the region.
    118116     * @param   pvAddressR3         R3 address of mapped region.
    119117     * @param   pvAddressR0         R0 address of mapped region.
    … …  
    122120     */
    123121    DECLR3CALLBACKMEMBER(int, pfnUnmapRegion, (PPDMIPCIRAWUP pInterface,
    124                                                int                  iRegion,
    125                                                RTHCPHYS             StartAddress,
    126                                                uint64_t             iRegionSize,
    127                                                RTR3PTR              pvAddressR3,
    128                                                RTR0PTR              pvAddressR0
    129                                                ));
     122                                               uint32_t      iRegion,
     123                                               RTHCPHYS      StartAddress,
     124                                               uint64_t      cbRegion,
     125                                               RTR3PTR       pvAddressR3,
     126                                               RTR0PTR       pvAddressR0));
    130127
    131128    /**
    … …  
    134131     * @returns status code
    135132     * @param   pInterface          Pointer to this interface structure.
    136      * @param   iPort               IO port.
    137      * @param   iValue              Value to write.
     133     * @param   uPort               I/O port address.
     134     * @param   uValue              Value to write.
    138135     * @param   cb                  Access width.
    139136     *
    … …  
    141138     */
    142139    DECLR3CALLBACKMEMBER(int, pfnPioWrite, (PPDMIPCIRAWUP pInterface,
    143                                             uint16_t             iPort,
    144                                             uint32_t             iValue,
    145                                             unsigned             cb
    146                                             ));
     140                                            RTIOPORT      uPort,
     141                                            uint32_t      uValue,
     142                                            unsigned      cb));
    147143
    148144    /**
    … …  
    151147     * @returns status code
    152148     * @param   pInterface          Pointer to this interface structure.
    153      * @param   iPort               IO port.
    154      * @param   piValue             Place to store read value.
     149     * @param   uPort               I/O port address.
     150     * @param   puValue             Place to store read value.
    155151     * @param   cb                  Access width.
    156152     *
    … …  
    159155
    160156    DECLR3CALLBACKMEMBER(int, pfnPioRead, (PPDMIPCIRAWUP pInterface,
    161                                            uint16_t             iPort,
    162                                            uint32_t             *piValue,
    163                                            unsigned             cb
    164                                            ));
     157                                           RTIOPORT      uPort,
     158                                           uint32_t     *puValue,
     159                                           unsigned      cb));
    165160
    166161
    … …  
    172167     * @param   pInterface          Pointer to this interface structure.
    173168     * @param   Address             Guest physical address.
    174      * @param   pValue              Address of value to write.
     169     * @param   pvValue             Address of value to write.
    175170     * @param   cb                  Access width.
    176171     *
    … …  
    178173     */
    179174    DECLR3CALLBACKMEMBER(int, pfnMmioWrite, (PPDMIPCIRAWUP pInterface,
    180                                              RTR0PTR              Address,
    181                                              void const          *pValue,
    182                                              unsigned             cb
    183                                              ));
     175                                             RTR0PTR       Address, /**< Why is this documented as guest physical address and given a host ring-0 address type??? */
     176                                             void const   *pvValue,
     177                                             unsigned      cb));
    184178
    185179    /**
    … …  
    189183     * @param   pInterface          Pointer to this interface structure.
    190184     * @param   Address             Guest physical address.
    191      * @param   pValue              Place to store read value.
     185     * @param   pvValue             Place to store read value.
    192186     * @param   cb                  Access width.
    193187     *
    … …  
    196190
    197191    DECLR3CALLBACKMEMBER(int, pfnMmioRead, (PPDMIPCIRAWUP pInterface,
    198                                             RTR0PTR              Address,
    199                                             void                 *pValue,
    200                                             unsigned             cb
    201                                             ));
     192                                            RTR0PTR       Address, /**< Why is this documented as guest physical address and given a host ring-0 address type??? */
     193                                            void         *pvValue,
     194                                            unsigned      cb));
    202195
    203196    /**
    … …  
    210203     * @returns status code
    211204     * @param   pInterface          Pointer to this interface structure.
    212      * @param   iOffset             Offset in PCI config space.
    213      * @param   iValue              Value to write.
     205     * @param   offCfgSpace         Offset in PCI config space.
     206     * @param   pvValue             Value to write.
    214207     * @param   cb                  Access width.
    215208     *
    … …  
    217210     */
    218211    DECLR3CALLBACKMEMBER(int, pfnPciCfgWrite, (PPDMIPCIRAWUP pInterface,
    219                                                uint32_t             iOffset,
    220                                                void*                pValue,
    221                                                unsigned             cb
    222                                                ));
     212                                               uint32_t      offCfgSpace,
     213                                               void         *pvValue,
     214                                               unsigned      cb));
    223215     /**
    224216     * Request driver to read value from host device's PCI config space.
    … …  
    227219     * @returns status code
    228220     * @param   pInterface          Pointer to this interface structure.
    229      * @param   iOffset             Offset in PCI config space.
    230      * @param   pValue              Where to store read value.
     221     * @param   offCfgSpace         Offset in PCI config space.
     222     * @param   pvValue             Where to store read value.
    231223     * @param   cb                  Access width.
    232224     *
    … …  
    234226     */
    235227    DECLR3CALLBACKMEMBER(int, pfnPciCfgRead, (PPDMIPCIRAWUP pInterface,
    236                                               uint32_t             iOffset,
    237                                               void                *pValue,
    238                                               unsigned             cb                                              ));
     228                                              uint32_t      offCfgSpace,
     229                                              void         *pvValue,
     230                                              unsigned      cb));
    239231
    240232    /**
    … …  
    252244     * @param   pInterface          Pointer to this interface structure.
    253245     * @param   pListener           Pointer to the listener object.
    254      * @param   iGuestIrq           Guest IRQ to be passed to pfnInterruptRequest().
     246     * @param   uGuestIrq           Guest IRQ to be passed to pfnInterruptRequest().
    255247     *
    256248     * @thread  Any thread, pfnInterruptRequest() will be usually invoked on a dedicated thread.
    257249     */
    258     DECLR3CALLBACKMEMBER(int, pfnEnableInterruptNotifications, (PPDMIPCIRAWUP pInterface, int32_t iGuestIrq
    259                                                                 ));
     250    DECLR3CALLBACKMEMBER(int, pfnEnableInterruptNotifications, (PPDMIPCIRAWUP pInterface, uint8_t uGuestIrq));
    260251
    261252    /**
    … …  
    267258     * @thread  Any thread.
    268259     */
    269     DECLR3CALLBACKMEMBER(int, pfnDisableInterruptNotifications, (PPDMIPCIRAWUP pInterface
    270                                                                  ));
    271 
    272     /**
    273      * Notification APIs.
    274      */
    275 
    276     /**
    277      * Notify driver when raw PCI device construction starts. Have to be the first operation
    278      * as initializes internal state and opens host device driver.
    279      *
    280      * @returns status code
    281      * @param   pInterface          Pointer to this interface structure.
    282      * @param   iHostAddress        Host PCI address of device attached.
    283      * @param   iGuestAddress       Guest PCI address of device attached.
    284      * @param   szDeviceName        Human readable device name.
     260    DECLR3CALLBACKMEMBER(int, pfnDisableInterruptNotifications, (PPDMIPCIRAWUP pInterface));
     261
     262    /** @name  Notification APIs.
     263     * @{
     264     */
     265
     266    /**
     267     * Notify driver when raw PCI device construction starts.
     268     *
     269     * Have to be the first operation as initializes internal state and opens host
     270     * device driver.
     271     *
     272     * @returns status code
     273     * @param   pInterface          Pointer to this interface structure.
     274     * @param   uHostPciAddress     Host PCI address of device attached.
     275     * @param   uGuestPciAddress    Guest PCI address of device attached.
     276     * @param   pszDeviceName       Human readable device name.
    285277     * @param   fDeviceFlags        Flags for the host device.
    286      * @param   pu32Flags           Flags for virtual device, from the upper driver.
     278     * @param   pfFlags             Flags for virtual device, from the upper driver.
    287279     *
    288280     * @thread  Any thread.
    289281     */
    290282    DECLR3CALLBACKMEMBER(int, pfnPciDeviceConstructStart, (PPDMIPCIRAWUP  pInterface,
    291                                                            uint32_t             iHostAddress,
    292                                                            uint32_t             iGuestAddress,
    293                                                            const char*          szDeviceName,
    294                                                            uint32_t             fDeviceFlags,
    295                                                            uint32_t             *pu32Flags));
     283                                                           uint32_t       uHostPciAddress,
     284                                                           uint32_t       uGuestPciAddress,
     285                                                           const char    *pszDeviceName,
     286                                                           uint32_t       fDeviceFlags,
     287                                                           uint32_t      *pfFlags));
    296288
    297289    /**
    … …  
    305297     * @thread  Any thread.
    306298     */
    307     DECLR3CALLBACKMEMBER(void, pfnPciDeviceConstructComplete, (PPDMIPCIRAWUP pInterface,
    308                                                                int                  rc));
     299    DECLR3CALLBACKMEMBER(void, pfnPciDeviceConstructComplete, (PPDMIPCIRAWUP pInterface, int rc));
    309300
    310301    /**
    … …  
    315306     * @thread  Any thread.
    316307     */
    317     DECLR3CALLBACKMEMBER(int, pfnPciDeviceDestruct, (PPDMIPCIRAWUP pInterface,
    318                                                      uint32_t             fFlags));
     308    DECLR3CALLBACKMEMBER(int, pfnPciDeviceDestruct, (PPDMIPCIRAWUP pInterface, uint32_t fFlags));
    319309
    320310    /**
    … …  
    322312     *
    323313     * @param   pInterface          Pointer to this interface structure.
    324      * @param   aState              New power state.
     314     * @param   enmState            New power state.
    325315     * @param   pu64Param           State-specific in/out parameter. For now only used during power-on to provide VM caps.
    326316     *
    327317     * @thread  Any thread.
    328318     */
    329     DECLR3CALLBACKMEMBER(int, pfnPciDevicePowerStateChange, (PPDMIPCIRAWUP pInterface,
    330                                                              PCIRAWPOWERSTATE     aState,
    331                                                              uint64_t             *pu64Param));
    332 
    333      /**
     319    DECLR3CALLBACKMEMBER(int, pfnPciDevicePowerStateChange, (PPDMIPCIRAWUP      pInterface,
     320                                                             PCIRAWPOWERSTATE   enmState,
     321                                                             uint64_t          *pu64Param));
     322
     323    /**
    334324     * Notify driver about runtime error.
    335325     *
    … …  
    342332     */
    343333    DECLR3CALLBACKMEMBER(int, pfnReportRuntimeError, (PPDMIPCIRAWUP pInterface,
    344                                                       uint8_t              fFatal,
    345                                                       const char*          szErrorId,
    346                                                       const char*          szMessage));
     334                                                      bool          fFatal,
     335                                                      const char   *pszErrorId,
     336                                                      const char   *pszMessage));
     337    /** @} */
    347338} PDMIPCIRAWUP;
    348339
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