次の方法で共有

StopAndAnalyzeTracingSession

  • [アーティクル]

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

StopAndAnalyzeTracingSession 関数により、実行中のトレース セッションが停止されて、結果のトレースが一時ファイルに保存されます。 その後、その一時ファイルを入力として使用して、分析セッションが直ちに開始されます。 この関数を呼び出す実行可能ファイルには、管理者権限が必要です。

構文

template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
    const char*                                   sessionName,
    unsigned                                      numberOfAnalysisPasses,
    TRACING_SESSION_STATISTICS*                   statistics,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);

template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
    const wchar_t*                                sessionName,
    unsigned                                      numberOfAnalysisPasses,
    TRACING_SESSION_STATISTICS*                   statistics,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);

パラメーター

sessionName
停止するトレース セッションの名前。 StartTracingSession、StartTracingSessionA、StartTracingSessionW に渡したものと同じセッション名を使用します。

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

statistics
TRACING_SESSION_STATISTICS オブジェクトへのポインター。 StopAndAnalyzeTracingSession によって、戻る前に、このオブジェクトのトレース コレクション統計情報が書き込まれます。

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

戻り値

RESULT_CODE 列挙型の結果コード。