C++ Build Insights SDK 與 Visual Studio 2017 和更新版本相容。 若要查看這些版本的文件,請將本文的 Visual Studio 版本選取器控制項設定為 Visual Studio 2017 或更新版本。 其位於此頁面目錄頂端。
函 StopAndAnalyzeTracingSession 式會停止進行中的追蹤會話,並將產生的追蹤儲存在暫存盤中。 然後,分析會話會立即開始使用暫存盤做為輸入。 呼叫此函式的可執行文件必須具有系統管理員許可權。
語法
template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
const char* sessionName,
unsigned numberOfAnalysisPasses,
TRACING_SESSION_STATISTICS* statistics,
StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);
template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
const wchar_t* sessionName,
unsigned numberOfAnalysisPasses,
TRACING_SESSION_STATISTICS* statistics,
StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);
參數
sessionName
要停止的追蹤會話名稱。 使用與傳遞至 StartTracingSession、 StartTracingSessionA 或 StartTracingSessionW 的會話名稱相同。
分析次數
在追蹤上執行的分析傳遞數目。 追蹤會在每個分析階段通過所提供的分析器群組一次。
統計資料
TRACING_SESSION_STATISTICS 物件的指標。
StopAndAnalyzeTracingSession 在傳回之前,會寫入這個 對象的追蹤集合統計數據。
analyzerGroup
用於分析的分析器群組。 呼叫 MakeStaticAnalyzerGroup 以建立分析器群組。 如果您想要使用從 MakeDynamicAnalyzerGroup 取得的動態分析器群組,請先將地址傳遞至 ,將其封裝在 MakeStaticAnalyzerGroup靜態分析器群組中。
傳回值
來自 RESULT_CODE 列舉的結果碼。