Changeset 7277 in vbox for trunk/include/VBox

Timestamp:

Mar 4, 2008 2:12:17 PM (17 years ago)

Author:

vboxsync

Message:

Make the backend type a per-image property and get away from the per container property. Required e.g. for snapshotting iSCSI disks (whenever we get there).

File:

• trunk/include/VBox/VBoxHDD-new.h (modified) (9 diffs)

trunk/include/VBox/VBoxHDD-new.h

@@ -202 +202 @@
  *
  * @returns VBox status code.
- * @param   pszBackend      Name of the image file backend to use.
  * @param   pfnError        Callback for setting extended error information.
  * @param   pvErrorUser     Opaque parameter for pfnError.
  * @param   ppDisk          Where to store the reference to HDD container.
  */
-VBOXDDU_DECL(int) VDCreate(const char *pszBackend, PFNVDERROR pfnError,
-                           void *pvErrorUser, PVBOXHDD *ppDisk);
+VBOXDDU_DECL(int) VDCreate(PFNVDERROR pfnError, void *pvErrorUser,
+                           PVBOXHDD *ppDisk);
 
 /**
@@ -243 +242 @@
  * @returns VBox status code.
  * @param   pDisk           Pointer to HDD container.
+ * @param   pszBackend      Name of the image file backend to use.
  * @param   pszFilename     Name of the image file to open.
  * @param   uOpenFlags      Image file open mode, see VD_OPEN_FLAGS_* constants.
  */
-VBOXDDU_DECL(int) VDOpen(PVBOXHDD pDisk, const char *pszFilename,
-                         unsigned uOpenFlags);
+VBOXDDU_DECL(int) VDOpen(PVBOXHDD pDisk, const char *pszBackend,
+                         const char *pszFilename, unsigned uOpenFlags);
 
 /**
@@ -254 +254 @@
  * @returns VBox status code.
  * @param   pDisk           Pointer to HDD container.
+ * @param   pszBackend      Name of the image file backend to use.
  * @param   pszFilename     Name of the image file to create.
  * @param   enmType         Image type, only base image types are acceptable.
@@ -265 +266 @@
  * @param   pvUser          User argument for the progress callback.
  */
-VBOXDDU_DECL(int) VDCreateBase(PVBOXHDD pDisk, const char *pszFilename,
-                               VDIMAGETYPE enmType, uint64_t cbSize,
-                               unsigned uImageFlags, const char *pszComment,
+VBOXDDU_DECL(int) VDCreateBase(PVBOXHDD pDisk, const char *pszBackend,
+                               const char *pszFilename, VDIMAGETYPE enmType,
+                               uint64_t cbSize, unsigned uImageFlags,
+                               const char *pszComment,
                                PCPDMMEDIAGEOMETRY pPCHSGeometry,
                                PCPDMMEDIAGEOMETRY pLCHSGeometry,
@@ -279 +281 @@
  * @returns VBox status code.
  * @param   pDisk           Pointer to HDD container.
+ * @param   pszBackend      Name of the image file backend to use.
  * @param   pszFilename     Name of the differencing image file to create.
  * @param   uImageFlags     Flags specifying special image features.
@@ -286 +289 @@
  * @param   pvUser          User argument for the progress callback.
  */
-VBOXDDU_DECL(int) VDCreateDiff(PVBOXHDD pDisk, const char *pszFilename,
-                               unsigned uImageFlags, const char *pszComment,
-                               unsigned uOpenFlags, PFNVMPROGRESS pfnProgress,
-                               void *pvUser);
+VBOXDDU_DECL(int) VDCreateDiff(PVBOXHDD pDisk, const char *pszBackend,
+                               const char *pszFilename, unsigned uImageFlags,
+                               const char *pszComment, unsigned uOpenFlags,
+                               PFNVMPROGRESS pfnProgress, void *pvUser);
 
 /**
@@ -313 +316 @@
  * The copy is opened in the target HDD container.
  * It is possible to convert between different image formats, because the
- * backend for the destination HDD container may be different from the
- * source container.
+ * backend for the destination may be different from the source.
  * If both the source and destination reference the same HDD container,
  * then the image is moved (by copying/deleting or renaming) to the new location.
@@ -325 +327 @@
  * @param   nImage          Image number, counts from 0. 0 is always base image of container.
  * @param   pDiskTo         Pointer to destination HDD container.
+ * @param   pszBackend      Name of the image file backend to use (may be NULL to use the same as the source).
  * @param   pszFilename     New name of the image (may be NULL if pDiskFrom == pDiskTo).
  * @param   fMoveByRename   If true, attempt to perform a move by renaming (if successful the new size is ignored).
@@ -332 +335 @@
  */
 VBOXDDU_DECL(int) VDCopy(PVBOXHDD pDiskFrom, unsigned nImage, PVBOXHDD pDiskTo,
-                         const char *pszFilename, bool fMoveByRename,
-                         uint64_t cbSize, PFNVMPROGRESS pfnProgress,
-                         void *pvUser);
+                         const char *pszBackend, const char *pszFilename,
+                         bool fMoveByRename, uint64_t cbSize,
+                         PFNVMPROGRESS pfnProgress, void *pvUser);
 
 /**