Changeset 7752 in vbox for trunk/include/VBox/pdmdev.h

Timestamp:

Apr 4, 2008 5:35:14 PM (17 years ago)

Author:

vboxsync

Message:

Dropped the pszDesc argument to *MMIORegisterGC/R0. It only persists in the PDMDEVHLP interface now because of binary compatability.

File:

• trunk/include/VBox/pdmdev.h (modified) (4 diffs)

trunk/include/VBox/pdmdev.h

@@ -1756 +1756 @@
      * @param   pszRead             Name of the GC function which is gonna handle Read operations.
      * @param   pszFill             Name of the GC function which is gonna handle Fill/memset operations. (optional)
-     * @param   pszDesc             Pointer to description string. This must not be freed.
+     * @param   pszDesc             Obsolete. NULL is fine.
+     * @todo    Remove pszDesc in the next major revision of PDMDEVHLP.
      */
     DECLR3CALLBACKMEMBER(int, pfnMMIORegisterGC,(PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange, RTGCPTR pvUser,
@@ -1776 +1777 @@
      * @param   pszRead             Name of the GC function which is gonna handle Read operations.
      * @param   pszFill             Name of the GC function which is gonna handle Fill/memset operations. (optional)
-     * @param   pszDesc             Pointer to description string. This must not be freed.
+     * @param   pszDesc             Obsolete. NULL is fine.
+     * @todo    Remove pszDesc in the next major revision of PDMDEVHLP.
      */
     DECLR3CALLBACKMEMBER(int, pfnMMIORegisterR0,(PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange, RTR0PTR pvUser,
@@ -3110 +3112 @@
  */
 DECLINLINE(int) PDMDevHlpMMIORegisterGC(PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange, RTGCPTR pvUser,
-                                        const char *pszWrite, const char *pszRead, const char *pszFill, const char *pszDesc)
-{
-    return pDevIns->pDevHlp->pfnMMIORegisterGC(pDevIns, GCPhysStart, cbRange, pvUser, pszWrite, pszRead, pszFill, pszDesc);
+                                        const char *pszWrite, const char *pszRead, const char *pszFill)
+{
+    return pDevIns->pDevHlp->pfnMMIORegisterGC(pDevIns, GCPhysStart, cbRange, pvUser, pszWrite, pszRead, pszFill, NULL);
 }
 
@@ -3119 +3121 @@
  */
 DECLINLINE(int) PDMDevHlpMMIORegisterR0(PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange, RTR0PTR pvUser,
-                                        const char *pszWrite, const char *pszRead, const char *pszFill, const char *pszDesc)
-{
-    return pDevIns->pDevHlp->pfnMMIORegisterR0(pDevIns, GCPhysStart, cbRange, pvUser, pszWrite, pszRead, pszFill, pszDesc);
+                                        const char *pszWrite, const char *pszRead, const char *pszFill)
+{
+    return pDevIns->pDevHlp->pfnMMIORegisterR0(pDevIns, GCPhysStart, cbRange, pvUser, pszWrite, pszRead, pszFill, NULL);
 }