Partager via


Analyser la fonction

Le SDK Build Insights C++ est compatible avec Visual Studio 2017 et ultérieur. Pour consulter la documentation de ces versions, définissez le contrôle de sélecteur Version de Visual Studio pour cet article sur Visual Studio 2017 ou ultérieur. Il se trouve en haut de la table des matières de cette page.

La Analyze fonction est utilisée pour analyser une trace de suivi d’événements pour Windows (ETW) obtenue à partir de MSVC lors du suivi d’une build C++. Les événements de la trace ETW sont transférés séquentiellement vers un groupe d’analyseurs fourni par l’appelant. Cette fonction prend en charge les analyses à plusieurs passes qui permettent de transférer le flux d’événements au groupe d’analyseurs plusieurs fois dans une ligne.

Syntaxe

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

Paramètres

TAnalyzerGroupMembers
Ce paramètre est toujours déduit.

inputLogFile
Trace ETW d’entrée à partir de laquelle vous souhaitez lire les événements.

numberOfPasses
Nombre d’analyses passées à exécuter sur la trace d’entrée. La trace est transmise par le groupe d’analyseurs fourni une fois par passe d’analyse.

analyzerGroup
Groupe d’analyseurs utilisé pour l’analyse. Appelez MakeStaticAnalyzerGroup pour créer un groupe d’analyseurs. Pour utiliser un groupe d’analyseurs dynamiques obtenu à partir de MakeDynamicAnalyzerGroup, commencez par l’encapsuler dans un groupe d’analyseurs statiques en passant son adresse à MakeStaticAnalyzerGroup.

Valeur de retour

Code de résultat de l’énumération RESULT_CODE .