Analysefunktion

Das C++ Build Insights SDK ist mit Visual Studio 2017 und höher kompatibel. Um die Dokumentation für diese Versionen anzuzeigen, legen Sie das Auswahlsteuerelement Version in Visual Studio für diesen Artikel auf Visual Studio 2017 oder höher fest. Es befindet sich am Anfang des Inhaltsverzeichnisses auf dieser Seite.

Die Funktion Analyze dient zur Analyse einer Ereignisablaufverfolgung für Windows (ETW), die von MSVC während der Ablaufverfolgung eines C++-Builds abgerufen wird. Die Ereignisse in der Ereignisablaufverfolgung für Windows werden sequenziell an eine vom Aufrufer bereitgestellte Analysetoolgruppe weitergeleitet. Diese Funktion unterstützt Analysen mit mehreren Durchläufen, die es ermöglichen, den Ereignisdatenstrom mehrmals hintereinander an die Analysetoolgruppe weiterzuleiten.

Syntax

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

Parameter

TAnalyzerGroupMembers
Dieser Parameter wird immer hergeleitet.

inputLogFile
Die Eingabe-ETW, aus der Ereignisse gelesen werden sollen.

numberOfPasses
Anzahl der Analysedurchläufe, die für die Eingabeablaufverfolgung ausgeführt werden sollen. Die Ablaufverfolgung durchläuft die angegebene Analysegruppe einmal pro Analysedurchlauf.

analyzerGroup
Die Analysetoolgruppe, die für die Analyse verwendet wird. Rufen Sie MakeStaticAnalyzerGroup auf, um eine Analysetoolgruppe zu erstellen. Wenn Sie eine dynamische Analysetoolgruppe verwenden möchten, die aus MakeDynamicAnalyzerGroup abgerufen wurde, kapseln Sie sie zuerst in einer statischen Analysetoolgruppe, indem Sie deren Adresse an MakeStaticAnalyzerGroup übergeben.

Rückgabewert

Ein Ergebniscode aus der Enumeration RESULT_CODE.