分享方式：

StopAndAnalyzeTracingSession

  • 文章

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 的會話名稱相同。

numberOfAnalysisPasses
在追蹤上執行的分析傳遞數目。 追蹤會在每個分析階段通過所提供的分析器群組一次。

統計
TRACING_SESSION_STATISTICS 物件的指標。 StopAndAnalyzeTracingSession 在傳回之前，會寫入這個 物件的追蹤集合統計資料。

analyzerGroup
用於分析的分析器群組。 呼叫 MakeStaticAnalyzerGroup 以建立分析器群組。 如果您想要使用從 MakeDynamicAnalyzerGroup 取得的動態分析器群組，請先將位址傳遞至 ，將其封裝在 MakeStaticAnalyzerGroup 靜態分析器群組中。

傳回值

來自 RESULT_CODE 列舉的結果碼。