Changeset 85894 in vbox for trunk/src/VBox/Runtime/include

Timestamp:

Aug 26, 2020 8:50:52 PM (4 years ago)

Author:

vboxsync

Message:

IPRT/Dvm: Added RTDvmMapQueryTableLocations (for VMDK). Completely untested. bugref:9224

File:

• trunk/src/VBox/Runtime/include/internal/dvm.h (modified) (1 diff)

trunk/src/VBox/Runtime/include/internal/dvm.h

@@ -185 +185 @@
 
     /**
+     * Query the partition table locations.
+     *
+     * @returns IPRT status code.
+     * @retval  VERR_BUFFER_OVERFLOW if the table is too small, @a *pcActual will be
+     *          set to the required size.
+     * @retval  VERR_BUFFER_UNDERFLOW if the table is too big and @a pcActual is
+     *          NULL.
+     * @param   hVolMgrFmt      The format specific volume manager handle.
+     * @param   fFlags          Flags, see RTDVMMAPQTABLOC_F_XXX.
+     * @param   paLocations     Where to return the info. Ignored if @a cLocations
+     *                          is zero, then only @a pcActual matters.
+     * @param   cLocations      The size of @a paLocations in items.
+     * @param   pcActual        Where to return the actual number of locations, or
+     *                          on VERR_BUFFER_OVERFLOW the necessary table size.
+     *                          Optional, when not specified the cLocations value
+     *                          must match exactly or it fails with
+     *                          VERR_BUFFER_UNDERFLOW.
+     * @sa RTDvmMapQueryTableLocations
+     */
+    DECLCALLBACKMEMBER(int, pfnQueryTableLocations,(RTDVMFMT hVolMgrFmt, uint32_t fFlags, PRTDVMTABLELOCATION paLocations,
+                                                    size_t cLocations, size_t *pcActual));
+
+    /**
      * Closes a volume handle.
      *