TdhGetEventInformation 関数 (tdh.h)

  • [アーティクル]

イベントに関するメタデータを取得します。

構文

TDHSTATUS TdhGetEventInformation(
  [in]      PEVENT_RECORD     Event,
  [in]      ULONG             TdhContextCount,
  [in]      PTDH_CONTEXT      TdhContext,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] PULONG            BufferSize
);

パラメーター

[in] Event

EventRecordCallback コールバックに渡されるイベント レコード。 詳細については、EVENT_RECORD構造に関するページ を 参照してください。

[in] TdhContextCount

pTdhContext 内の要素の数。

[in] TdhContext

WPP またはクラシック ETW イベントのみのコンテキスト値の配列。それ以外の場合は NULL。 詳細については、TDH_CONTEXT構造に 関するページを 参照してください。 配列に重複するコンテキスト型を含めてはいけません。

[out] Buffer

イベント情報を受信するためのユーザー割り当てバッファー。 詳細については、TRACE_EVENT_INFO構造に 関するページを 参照してください。

[in, out] BufferSize

pBuffer バッファーのサイズ (バイト単位)。 関数が成功した場合、このパラメーターは使用されるバッファーのサイズを受け取ります。 バッファーが小さすぎる場合、関数は ERROR_INSUFFICIENT_BUFFERを返し、このパラメーターを必要なバッファー サイズに設定します。 入力時にバッファー サイズが 0 の場合、バッファーにデータは返されません。このパラメーターは必要なバッファー サイズを受け取ります。

戻り値

成功した場合は、ERROR_SUCCESSを返します。 それ以外の場合、この関数は、他の戻りコードに加えて、次のいずれかのリターン コードを返します。

リターン コード 説明
ERROR_INSUFFICIENT_BUFFER
 pBuffer バッファーのサイズが小さすぎます。 新しいバッファーを割り当てるには、 pBufferSize で必要なバッファー サイズ セットを使用します。
ERROR_NOT_FOUND
 イベントのスキーマが見つかりませんでした。
ERROR_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。
ERROR_FILE_NOT_FOUND
 マニフェストの resourceFileName 属性には、プロバイダー バイナリの場所が含まれています。 マニフェストを登録すると、場所がレジストリに書き込まれます。 TDH は、登録された場所に基づいてバイナリを見つけることができませんでした。
ERROR_WMI_SERVER_UNAVAILABLE
 WMI サービスは使用できません。

注釈

イベントが WPP またはレガシ ETW イベントの場合は、イベント情報の解析に使用されるコンテキスト情報を指定できます。 EVENT_HEADER_FLAG_TRACE_MESSAGE フラグが EVENT_HEADER の Flags メンバーに設定されている場合、イベントは WPP イベントです (EVENT_RECORD の EventHeader メンバーを参照)。 EVENT_HEADER_FLAG_CLASSIC_HEADER フラグが設定されている場合、イベントはレガシ ETW イベントです。

例

イベントに関するメタデータを取得する方法を示す例については、「 TdhFormatProperty を使用してイベント データを使用する」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー tdh.h
Library Tdh.lib
[DLL] Tdh.dll

こちらもご覧ください

TdhGetEventMapInformation

TdhGetProperty