Changeset 21806 in vbox for trunk/include

Timestamp:

Jul 27, 2009 10:14:11 AM (16 years ago)

Author:

vboxsync

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

50410

Message:

Storage/VBoxHDD: resurrect the facility to dump information about disk images, and bare minimum fix for creating diff images.

File:

• trunk/include/VBox/VBoxHDD.h (modified) (3 diffs)

trunk/include/VBox/VBoxHDD.h

@@ -336 +336 @@
 
 /**
- * Interface to deliver error messages to upper layers.
+ * Interface to deliver error messages (and also informational messages)
+ * to upper layers.
  *
  * Per disk interface. Optional, but think twice if you want to miss the
@@ -354 +355 @@
 
     /**
-     * Error message callback.
+     * Error message callback. Must be able to accept special IPRT format
+     * strings.
      *
      * @param   pvUser          The opaque data passed on container creation.
@@ -363 +365 @@
      */
     DECLR3CALLBACKMEMBER(void, pfnError, (void *pvUser, int rc, RT_SRC_POS_DECL, const char *pszFormat, va_list va));
+
+    /**
+     * Informational message callback. May be NULL. Used e.g. in
+     * VDDumpImages(). Must be able to accept special IPRT format strings.
+     *
+     * @return  VBox status code.
+     * @param   pvUser          The opaque data passed on container creation.
+     * @param   pszFormat       Error message format string.
+     * @param   ...             Error message arguments.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnMessage, (void *pvUser, const char *pszFormat, ...));
 
 } VDINTERFACEERROR, *PVDINTERFACEERROR;