Changeset 19034 in vbox for trunk/src/VBox/Devices

Timestamp:

Apr 20, 2009 3:42:34 PM (16 years ago)

Author:

vboxsync

Message:

Storage/VBoxHDD: stub for compacting images

File:

• trunk/src/VBox/Devices/Storage/VBoxHDD.cpp (modified) (1 diff)

trunk/src/VBox/Devices/Storage/VBoxHDD.cpp

@@ -2110 +2110 @@
 
 /**
+ * Optimizes the storage consumption of an image. Typically the unused blocks
+ * have to be wiped with zeroes to achieve a substantial reduced storage use.
+ * Another optimization done is reordering the image blocks, which can provide
+ * a significant performance boost, as reads and writes tend to use less random
+ * file offsets.
+ *
+ * @return  VBox status code.
+ * @return  VERR_VD_IMAGE_NOT_FOUND if image with specified number was not opened.
+ * @return  VERR_VD_IMAGE_READ_ONLY if image is not writable.
+ * @return  VERR_NOT_SUPPORTED if this kind of image cannot be compacted.
+ * @return  VERR_NOT_IMPLEMENTED if this kind of image can be compacted, but
+ *                               the code for this isn't implemented yet.
+ * @param   pDisk           Pointer to HDD container.
+ * @param   nImage          Image number, counts from 0. 0 is always base image of container.
+ * @param   pVDIfsOperation Pointer to the per-operation VD interface list.
+ */
+VBOXDDU_DECL(int) VDCompact(PVBOXHDD pDisk, unsigned nImage,
+                            PVDINTERFACE pVDIfsOperation)
+{
+    return VERR_NOT_SUPPORTED;
+}
+
+/**
  * Closes the last opened image file in HDD container.
  * If previous image file was opened in read-only mode (that is normal) and closing image