The C++ Build Insights SDK is compatible with Visual Studio 2017 and above. To see the documentation for these versions, set the Visual Studio Version selector control for this article to Visual Studio 2017 or Visual Studio 2019. It's found at the top of the table of contents on this page.
Analyze function is used to analyze an Event Tracing for Windows (ETW) trace obtained from MSVC while tracing a C++ build. The events in the ETW trace are forwarded sequentially to an analyzer group provided by the caller. This function supports multi-pass analyses that allow forwarding the event stream to the analyzer group multiple times in a row.
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);
This parameter is always deduced.
The input ETW trace that you wish to read events from.
The number of analysis passes to run on the input trace. The trace gets passed through the provided analyzer group once per analysis pass.
The analyzer group used for the analysis. Call MakeStaticAnalyzerGroup to create an analyzer group. To use a dynamic analyzer group obtained from MakeDynamicAnalyzerGroup, first encapsulate it inside a static analyzer group by passing its address to
A result code from the RESULT_CODE enum.