次の方法で共有


Analyze 関数

C++ Build Insights SDK は、Visual Studio 2017 以降と互換性があります。 これらのバージョンのドキュメントを表示するには、この記事の Visual Studio バージョン セレクター コントロールを Visual Studio 2017 以降に設定します。 このページの目次の一番上にあります。

Analyze 関数は、C++ ビルドのトレース中に MSVC から取得した Event Tracing for Windows (ETW) トレースを分析するために使用されます。 ETW トレースのイベントは、呼び出し元によって提供されるアナライザー グループに順次転送されます。 この関数では複数パスの分析がサポートされており、イベント ストリームをアナライザー グループに続けて複数回転送できます。

構文

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

パラメーター

TAnalyzerGroupMembers
このパラメーターは常に推測されます。

inputLogFile
イベントの読み取り元の入力 ETW トレース。

numberOfPasses
入力トレースに対して実行する分析パスの数。 トレースは、指定されたアナライザー グループを通して、分析パスごとに 1 回渡されます。

analyzerGroup
分析に使用するアナライザー グループ。 アナライザー グループを作成するには、MakeStaticAnalyzerGroup を呼び出します。 MakeDynamicAnalyzerGroup から取得された動的アナライザー グループを使用するには、最初に、そのアドレスを MakeStaticAnalyzerGroup に渡すことによって、静的なアナライザー グループ内にそれをカプセル化します。

戻り値

RESULT_CODE 列挙型の結果コード。