Partilhar via

StopAndAnalyzeTracingSession

  • Artigo

O SDK do C++ Build Insights é compatível com o Visual Studio 2017 e posterior. Para ver a documentação dessas versões, defina o controle seletor de Versão do Visual Studio deste artigo para o Visual Studio 2017 ou posterior. Ele é encontrado na parte superior da tabela de conteúdo nesta página.

A função StopAndAnalyzeTracingSession interrompe uma sessão de rastreamento em andamento e salva o rastreamento resultante em um arquivo temporário. Em seguida, uma sessão de análise é iniciada imediatamente usando o arquivo temporário como uma entrada. Os executáveis que chamam essa função devem ter privilégios de administrador.

Sintaxe

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

Parâmetros

sessionName
O nome da sessão de rastreamento a ser interrompida. Use o mesmo nome de sessão que o passado para StartTracingSession, StartTracingSessionA ou StartTracingSessionW.

numberOfAnalysisPasses
O número de passagens de análise a ser executado no rastreamento. O rastreamento é passado pelo grupo analisador fornecido uma vez por passagem de análise.

estatísticas
Ponteiro para um objeto TRACING_SESSION_STATISTICS. StopAndAnalyzeTracingSession grava estatísticas de coleção de rastreamento neste objeto antes de retornar.

analyzerGroup
O grupo analisador usado para a análise. Chame MakeStaticAnalyzerGroup para criar um grupo de analisadores. Se você quiser usar um grupo de analisadores dinâmicos obtido do MakeDynamicAnalyzerGroup, primeiro encapsule-o dentro de um grupo de analisadores estáticos passando seu endereço para MakeStaticAnalyzerGroup.

Valor de retorno

Um código de resultado da enumeração RESULT_CODE.