Changeset 89682 in vbox for trunk/include

Timestamp:

Jun 14, 2021 2:29:35 PM (4 years ago)

Author:

vboxsync

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

145130

Message:

VMM/DBGFR3SampleReport: More work on the sample creation code, bugref:10025

File:

• trunk/include/VBox/vmm/dbgf.h (modified) (2 diffs)

trunk/include/VBox/vmm/dbgf.h

@@ -3087 +3087 @@
  * @{ */
 
+/**
+ * Callback which provides progress information about a currently running
+ * lengthy operation.
+ *
+ * @return  VBox status code.
+ * @retval  VERR_DBGF_CANCELLED to cancel the operation.
+ * @param   pvUser          The opaque user data associated with this interface.
+ * @param   uPercentage     Completion percentage.
+ */
+typedef DECLCALLBACKTYPE(int, FNDBGFPROGRESS,(void *pvUser, unsigned uPercentage));
+/** Pointer to FNDBGFPROGRESS() */
+typedef FNDBGFPROGRESS *PFNDBGFPROGRESS;
+
 /** @name Flags to pass to DBGFR3SampleReportCreate().
  * @{ */
 /** The report creates the call stack in reverse order (bottom to top). */
-#define DBGF_SAMPLE_REPORT_F_UPSIDE_DOWN    RT_BIT(0)
+#define DBGF_SAMPLE_REPORT_F_STACK_REVERSE  RT_BIT(0)
 /** Mask containing the valid flags. */
-#define DBGF_AMPLE_REPORT_F_VALID_MASK      UINT32_C(0x00000001)
+#define DBGF_SAMPLE_REPORT_F_VALID_MASK     UINT32_C(0x00000001)
 /** @} */
 
@@ -3098 +3111 @@
 VMMR3DECL(uint32_t) DBGFR3SampleReportRetain(DBGFSAMPLEREPORT hSample);
 VMMR3DECL(uint32_t) DBGFR3SampleReportRelease(DBGFSAMPLEREPORT hSample);
-VMMR3DECL(int)      DBGFR3SampleReportStart(DBGFSAMPLEREPORT hSample);
+VMMR3DECL(int)      DBGFR3SampleReportStart(DBGFSAMPLEREPORT hSample, uint64_t cSampleUs, PFNDBGFPROGRESS pfnProgress, void *pvUser);
 VMMR3DECL(int)      DBGFR3SampleReportStop(DBGFSAMPLEREPORT hSample);
 VMMR3DECL(int)      DBGFR3SampleReportDumpToFile(DBGFSAMPLEREPORT hSample, const char *pszFilename);