Função Analyze

  • 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 Analyze é usada para analisar um rastreamento ETW (Rastreamento de Eventos para Windows) obtido do MSVC durante o rastreamento de um build C++. Os eventos no rastreamento ETW são encaminhados sequencialmente para um grupo de analisadores fornecido pelo chamador. Essa função dá suporte a análises multipassagem, que permitem encaminhar o fluxo de eventos para o grupo analisador várias vezes seguidas.

Sintaxe

template <typename... TAnalyzerGroupMembers>
RESULT_CODE Analyze(
    const char*                                   inputLogFile,
    unsigned                                      numberOfPasses,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);

template <typename... TAnalyzerGroupMembers>
RESULT_CODE Analyze(
    const wchar_t*                                inputLogFile,
    unsigned                                      numberOfPasses,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);

Parâmetros

TAnalyzerGroupMembers
Esse parâmetro é sempre deduzido.

inputLogFile
O rastreamento ETW de entrada do qual você deseja ler os eventos.

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

analyzerGroup
O grupo analisador usado para a análise. Chame MakeStaticAnalyzerGroup para criar um grupo de analisadores. Para 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 Devolução

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