InjectEvent

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

InjectEvent 関数は、IRelogger インターフェイスが実装されているリロガー内で呼び出されます。 再ログ記録セッションの出力トレース ファイルに Event Tracing for Windows (ETW) イベントを書き込むために使用されます。

構文

void InjectEvent(
    const void* relogSession,
    LPCGUID providerId,
    PCEVENT_DESCRIPTOR eventDescriptor,
    unsigned long processId,
    unsigned long threadId,
    unsigned short processorIndex,
    long long timestamp,
    unsigned char* data,
    unsigned long byteCount);

パラメーター

relogSession
再ログ記録セッションへのポインター。 再ログ記録セッションは、IRelogger インターフェイスが実装されているリロガーに提供されます。 詳細については、IRelogger に関する記事を参照してください。

providerId
ETW イベントが再ログ記録される Tracing for Windows (ETW) プロバイダー GUID。

eventDescriptor
再ログ記録される ETW イベントの ETW イベント記述子。

processId
再ログ記録される ETW イベントのプロセス識別子 (PID)。

threadId
再ログ記録される ETW イベントのスレッド識別子 (TID)。

processorIndex
再ログ記録される ETW イベントのプロセッサ インデックス。

timestamp
再ログ記録される ETW イベントのタイムスタンプ。

data
再ログ記録される ETW イベントに含める必要があるデータへのポインター。

byteCount
data によって示されるデータのサイズ (バイト単位)。

注釈

"プロバイダー GUID" や "イベント記述子" などの ETW の概念の詳細については、ETW のドキュメントを参照してください。 C++ Build Insights SDK を使用して再ログ記録セッションを開始する方法の詳細については、「Relog」を参照してください。