TraceInfo クラス

[アーティクル]
07/19/2022

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

TraceInfo クラスは、分析または再ログ記録の対象のトレースに関する有用なプロパティにアクセスするために使用されます。

構文

class TraceInfo
{
public:
    TraceInfo(const TRACE_INFO_DATA& data);

    const unsigned long& LogicalProcessorCount() const;

    const long long& TickFrequency() const;
    const long long& StartTimestamp() const;
    const long long& StopTimestamp() const;

    std::chrono::nanoseconds Duration() const;
};

解説

トレース全体で経過したティック数を得るには、StopTimestamp から StartTimestamp を減算します。得られた結果を時間単位に変換するには TickFrequency を使用します。ティック数を時間に変換する例については、EVENT_DATAに関する記事を参照してください。

ティック数を自分で変換したくない場合は、TraceInfo クラスで、トレース時間をナノ秒単位で返すメンバー関数が提供されています。この値を他の時間単位に変換するには、C++ の標準 chrono ライブラリを使用します。

メンバー

コンストラクター

TraceInfo

機能

Duration LogicalProcessorCount StartTimestamp StopTimestamp TickFrequency

期間

std::chrono::nanoseconds Duration() const;

戻り値

アクティビティの継続時間 (ナノ秒単位)。

LogicalProcessorCount

const unsigned long& LogicalProcessorCount() const;

戻り値

トレースが収集されたコンピューター上の論理プロセッサの数。

StartTimestamp

const long long& StartTimestamp() const;

戻り値

トレースが開始された時刻にキャプチャされたティック値。

StopTimestamp

const long long& StopTimestamp() const;

戻り値

トレースが停止された時刻にキャプチャされたティック値。

TickFrequency

const long long& TickFrequency() const;

戻り値

ティック単位で計測された期間を評価するときに使用する、1 秒あたりのティック数。

TraceInfo

TraceInfo(const TRACE_INFO_DATA& data);

パラメーター

data
トレースに関する情報が格納されているデータ。