TraceLoggingBinary マクロ (traceloggingprovider.h)

バイナリ データを含むフィールドをイベントに追加するトレース ログ ラッパー マクロ。

構文

void TraceLoggingBinary(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

パラメーター

[in] pValue

イベントに含めるデータへのポインター。

[in] cbValue

イベントに含めるデータのサイズ (バイト単位)。

[in, optional] __VA_ARGS__

フィールド定義の省略可能な 名前、 説明、 タグ パラメーター。

TraceLoggingBinary は、2、3、4、または 5 個のパラメーターで指定できます。 省略可能なパラメーターが指定されていない場合は、既定値が使用されます。 たとえば、TraceLoggingBinary(&x.data, sizeof(x.data)) は、TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0) と同じです。

• [in, optional] name

  イベント フィールドに使用する名前。 指定する場合、name パラメーターは文字列リテラル (変数ではない) であり、'\0' 文字を含めてはなりません。 指定しない場合、イベント フィールド名は pValue に基づいています。

• [in, optional] description

  イベント フィールドの値の説明。 指定した場合、description パラメーターは文字列リテラルである必要があり、 PDB に含まれます。

• [in, optional] tags

  コンパイル時の定数整数値。 値の下位 28 ビットは、フィールドのメタデータに含まれます。 この値のセマンティクスは、イベント コンシューマーによって定義されます。 イベント処理中に、この値は [EVENT_PROPERTY_INFO タグ] フィールドから取得できます。

戻り値

なし

解説

TraceLoggingBinary(pValue, cbValue, ...)は、TraceLoggingWrite マクロの呼び出しのパラメーターとして使用できます。 各 TraceLoggingBinary パラメーターは、イベントに 1 つのフィールドを追加します。

要件

関連項目

TraceLoggingWrite

トレース ログ ラッパー マクロ