Sdílet prostřednictvím


StopAndAnalyzeTracingSession

Sada C++ Build Insights SDK je kompatibilní se sadou Visual Studio 2017 a novějšími verzemi. Pokud chcete zobrazit dokumentaci k těmto verzím, nastavte ovládací prvek selektoru verzí sady Visual Studio pro tento článek na Visual Studio 2017 nebo novější. Nachází se v horní části obsahu na této stránce.

Funkce StopAndAnalyzeTracingSession zastaví probíhající trasovací relaci a uloží výsledné trasování do dočasného souboru. Relace analýzy se pak okamžitě spustí s použitím dočasného souboru jako vstupu. Spustitelné soubory, které tuto funkci volají, musí mít oprávnění správce.

Syntaxe

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);

Parametry

sessionName
Název relace trasování, která se má zastavit. Použijte stejný název relace jako název předaný startTracingSession, StartTracingSessionA nebo StartTracingSessionW.

numberOfAnalysisPasses
Počet předplatných analýzy, které se mají spustit na trasování. Trasování se projde zadanou skupinou analyzátoru jednou pro každý průchod analýzy.

statistiky
Ukazatel na objekt TRACING_SESSION_STATISTICS . StopAndAnalyzeTracingSession zapíše statistiku trasování kolekce v tomto objektu před vrácením.

analyzerGroup
Skupina analyzátorů používaná pro analýzu. Volání MakeStaticAnalyzerGroup vytvořit skupinu analyzátoru. Pokud chcete použít dynamickou skupinu analyzátorů získanou z MakeDynamicAnalyzerGroup, nejprve ji zapouzdřete do skupiny statických analyzátorů předáním jeho adresy MakeStaticAnalyzerGroup.

Návratová hodnota

Kód výsledku z výčtu RESULT_CODE .