Changeset 27806 in vbox for trunk/include

Timestamp:

Mar 29, 2010 8:18:50 PM (15 years ago)

Author:

vboxsync

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

59466

Message:

Storage/VBoxHDD+DrvBlock+DrvVD: implement core code for live snapshot merging.

File:

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

trunk/include/VBox/pdmifs.h

@@ -58 +58 @@
  * 'down' or 'up'.  This refers to a model with the device on the top and the
  * drivers stacked below it.  Sometimes there is mention of 'main' or 'external'
- * which normally means the same, i.e. the Main or VBoxBFE API.  Pickture the
- * orientation of 'main' as horisontal.
+ * which normally means the same, i.e. the Main or VBoxBFE API.  Picture the
+ * orientation of 'main' as horizontal.
  *
  * @{
@@ -806 +806 @@
 /** Pointer to a block notify interface (dummy). */
 typedef PDMIBLOCKPORT *PPDMIBLOCKPORT;
+
+
+/**
+ * Callback which provides progress information.
+ *
+ * @return  VBox status code.
+ * @param   pvUser          Opaque user data.
+ * @param   uPercent        Completion percentage.
+ */
+typedef DECLCALLBACK(int) FNSIMPLEPROGRESS(void *pvUser, unsigned uPercentage);
+/** Pointer to FNSIMPLEPROGRESS() */
+typedef FNSIMPLEPROGRESS *PFNSIMPLEPROGRESS;
 
 
@@ -903 +915 @@
 
     /**
+     * Merge medium contents during a live snapshot deletion.
+     *
+     * @returns VBox status code.
+     * @param   pInterface      Pointer to the interface structure containing the called function pointer.
+     * @param   pfnProgress     Function pointer for progress notification.
+     * @param   pvUser          Opaque user data for progress notification.
+     * @thread  Any thread.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnMerge,(PPDMIBLOCK pInterface, PFNSIMPLEPROGRESS pfnProgress, void *pvUser));
+
+    /**
      * Check if the media is readonly or not.
      *
@@ -1107 +1130 @@
      */
     DECLR3CALLBACKMEMBER(int, pfnFlush,(PPDMIMEDIA pInterface));
+
+    /**
+     * Merge medium contents during a live snapshot deletion. All details
+     * must have been configured through CFGM or this will fail.
+     * This method is optional (i.e. the function pointer may be NULL).
+     *
+     * @returns VBox status code.
+     * @param   pInterface      Pointer to the interface structure containing the called function pointer.
+     * @param   pfnProgress     Function pointer for progress notification.
+     * @param   pvUser          Opaque user data for progress notification.
+     * @thread  Any thread.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnMerge,(PPDMIMEDIA pInterface, PFNSIMPLEPROGRESS pfnProgress, void *pvUser));
 
     /**