Changeset 26160 in vbox for trunk/include/VBox

Timestamp:

Feb 2, 2010 6:23:29 PM (15 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

57174

Message:

PDM: s/pDevReg/pReg/g

Location:

trunk/include/VBox

Files:

• pdmdev.h (modified) (3 diffs)
• pdmusb.h (modified) (2 diffs)

trunk/include/VBox/pdmdev.h

@@ -57 +57 @@
  *
  * @returns VBox status.
- * @param   pDevIns     The device instance data.
- *                      If the registration structure is needed, pDevIns->pDevReg points to it.
+ * @param   pDevIns     The device instance data. If the registration structure
+ *                      is needed, it can be accessed thru  pDevIns->pReg.
  * @param   iInstance   Instance number. Use this to figure out which registers and such to use.
  *                      The instance number is also found in pDevIns->iInstance, but since it's
@@ -3490 +3490 @@
 
     /** Pointer to device registration structure.  */
-    R3PTRTYPE(PCPDMDEVREG)      pDevReg;
+    R3PTRTYPE(PCPDMDEVREG)      pReg;
     /** Configuration handle. */
     R3PTRTYPE(PCFGMNODE)        pCfgHandle;
@@ -4330 +4330 @@
      * @returns VBox status code.
      * @param   pCallbacks      Pointer to the callback table.
-     * @param   pDevReg         Pointer to the device registration record.
+     * @param   pReg            Pointer to the device registration record.
      *                          This data must be permanent and readonly.
      */
-    DECLR3CALLBACKMEMBER(int, pfnRegister,(PPDMDEVREGCB pCallbacks, PCPDMDEVREG pDevReg));
+    DECLR3CALLBACKMEMBER(int, pfnRegister,(PPDMDEVREGCB pCallbacks, PCPDMDEVREG pReg));
 
     /**

trunk/include/VBox/pdmusb.h

@@ -106 +106 @@
      * @returns VBox status.
      * @param   pUsbIns     The USB device instance data.
-     *                      If the registration structure is needed, pUsbDev->pDevReg points to it.
-     * @param   iInstance   Instance number. Use this to figure out which registers and such to use.
-     *                      The instance number is also found in pUsbDev->iInstance, but since it's
-     *                      likely to be freqently used PDM passes it as parameter.
-     * @param   pCfg        Configuration node handle for the device. Use this to obtain the configuration
-     *                      of the device instance. It's also found in pUsbDev->pCfg, but since it's
-     *                      primary usage will in this function it's passed as a parameter.
-     * @param   pCfgGlobal  Handle to the global device configuration. Also found in pUsbDev->pCfgGlobal.
+     *                      If the registration structure is needed,
+     *                      pUsbDev->pUsbReg points to it.
+     * @param   iInstance   Instance number. Use this to figure out which registers
+     *                      and such to use. The instance number is also found in
+     *                      pUsbDev->iInstance, but since it's likely to be
+     *                      freqently used PDM passes it as parameter.
+     * @param   pCfg        Configuration node handle for the device. Use this to
+     *                      obtain the configuration of the device instance. It's
+     *                      also found in pUsbDev->pCfg, but since it's primary
+     *                      usage will in this function it's passed as a parameter.
+     * @param   pCfgGlobal  Handle to the global device configuration. Also foundin
+     *                      pUsbDev->pCfgGlobal.
      * @remarks This callback is required.
      */
@@ -814 +818 @@
      * @returns VBox status code.
      * @param   pCallbacks      Pointer to the callback table.
-     * @param   pDevReg         Pointer to the device registration record.
+     * @param   pReg            Pointer to the USB device registration record.
      *                          This data must be permanent and readonly.
      */
-    DECLR3CALLBACKMEMBER(int, pfnRegister,(PCPDMUSBREGCB pCallbacks, PCPDMUSBREG pDevReg));
+    DECLR3CALLBACKMEMBER(int, pfnRegister,(PCPDMUSBREGCB pCallbacks, PCPDMUSBREG pReg));
 
     /**