WmiQueryTraceInformation 関数 (wdm.h)

  • [アーティクル]

WmiQueryTraceInformation ルーチンは、WMI イベント トレースに関する情報を返します。

構文

NTSTATUS WmiQueryTraceInformation(
  [in]            TRACE_INFORMATION_CLASS TraceInformationClass,
  [out]           PVOID                   TraceInformation,
  [in]            ULONG                   TraceInformationLength,
  [out, optional] PULONG                  RequiredLength,
  [in, optional]  PVOID                   Buffer
);

パラメーター

[in] TraceInformationClass

イベント トレースについて返す情報の種類を示す TRACE_INFORMATION_CLASS 列挙子を指定します。

[out] TraceInformation

呼び出し元によって割り当てられた出力バッファーへのポインター。ルーチンは、TraceInformationClassで指定されたイベント トレース情報 返します。

[in] TraceInformationLength

TraceInformation バッファーのサイズをバイト単位で指定します。

[out, optional] RequiredLength

TraceInformation バッファーの必要なサイズをバイト単位で指定するルーチンによって返される値へのポインター。 必要な長さ情報 使用しない場合、呼び出し元 RequiredLength を NULL を するように設定する必要があります。

[in, optional] Buffer

呼び出し元が提供するクエリ固有の入力情報へのポインター。 呼び出し元が指定した情報が不要な場合、呼び出し元はバッファー NULL設定する必要があります。

戻り値

リターン コード 形容
STATUS_SUCCESS
 成功
STATUS_INFO_LENGTH_MISMATCH
 TraceInformation バッファーのサイズが、指定したイベント トレース情報に必要なサイズと等しくありません。
STATUS_INVALID_HANDLE
 バッファー の (PWNODE_HEADER)メンバー HistoricalContext によって指定されたトレース ハンドルが無効です。
STATUS_INVALID_INFO_CLASS
 指定した種類のイベント トレース情報が無効です。
STATUS_INVALID_PARAMETER
 名前が指定されたトレース ハンドルを返すクエリで指定されたイベント トレースの名前が無効です。
STATUS_INVALID_PARAMETER_MIX
 呼び出し元は、指定されたイベント トレース情報に必要な情報を提供しませんでした。
STATUS_MORE_ENTRIES
 TraceInformation バッファーは、すべての有効なイベント トレース ハンドルの配列を保持するのに十分な大きさではありません。
STATUS_NOT_FOUND
 グローバル ロガーが見つかりませんでした。

備考

TraceInformationClassで指定 イベント トレース情報の種類ごとに、次の表に示します。

  • 入力要件
  • WmiQueryTraceInformation TraceInformation バッファーで返される情報
TraceClassInformation の値 入力要件 返される情報
TraceIdClass TraceInformationLength は、sizeof(ULONG) の値と等しくなります。

TraceInformation バッファーのサイズ (バイト単位) は、sizeof(ULONG) の値以上です。

(PWNODE_HEADER)Buffer の HistoricalContext メンバーは、イベント トレース ハンドルを指定します。

 *(PULONG)TraceInformation は、イベント トレース ハンドルのロガー ID に設定されます。
TraceHandleClass TraceInformationLength は、sizeof(TRACEHANDLE) の値と等しくなります。

TraceInformation バッファーのサイズ (バイト単位) は、sizeof(TRACEHANDLE) の値以上である必要があります。

*(PULONG)バッファー はロガー ID に設定されます。

 *(PTRACEHANDLE)TraceInformation は、指定されたロガーのイベント トレース ハンドルに設定されます。 指定したロガー ID が 0 の場合は、カーネル ロガーのイベント トレース ハンドルが返されます。
TraceEnableFlagsClass の TraceInformationLength は、(ULONG) の sizeof 値以上です。

TraceInformation バッファーのサイズ (バイト単位) は、sizeof(ULONG) の値以上である必要があります。

(PWNODE_HEADER)Buffer の HistoricalContext メンバーは、イベント トレース ハンドルを指定します。

 *(PULONG)TraceInformation は、指定されたイベント トレース ハンドルに設定されている有効フラグに設定されます。
TraceEnableLevelClass の TraceInformationLength は、の sizeof (ULONG) の値以上 設定されます。

TraceInformation バッファーのサイズ (バイト単位) は、sizeof(ULONG) の値以上である必要があります。

(PWNODE_HEADER)Buffer の HistoricalContext メンバーは、イベント トレース ハンドルを指定します。

 *(PULONG)TraceInformation は、指定されたイベント トレース ハンドルのレベルに設定されます。
GlobalLoggerHandleClass TraceInformationLength は、sizeof(TRACEHANDLE) の値と等しくなります。

TraceInformation バッファーのサイズ (バイト単位) は、sizeof(TRACEHANDLE) の値以上である必要があります。

 *(PTRACEHANDLE)TraceInformation は、グローバル ロガーのイベント トレース ハンドルに設定されます。
EventLoggerHandleClass 内部使用のみ。 内部使用のみ。
AllLoggerHandlesClass TraceInformationLength は、m TRACEHANDLE 値の配列のサイズ、バイト数に設定されます。

TraceInformation バッファーのサイズ (バイト単位) は、(m*sizeof(TRACEHANDLE)) の値以上である必要があります。

 TraceInformation バッファーには、n 個の トレース ハンドルの配列が含まれています。ここで、n は、最小 m、呼び出し元が指定したイベント トレース ハンドルの数、および有効なイベント トレース ハンドルの数です。 このルーチンは、TraceInformation バッファーが小さすぎてすべてのトレース ハンドルを保持するには、STATUS_MORE_ENTRIESの状態を返します。
TraceHandleByNameClass TraceInformationLength は、sizeof(TRACEHANDLE) の値に設定されます。

TraceInformation バッファーのサイズは、sizeof(TRACEHANDLE) の値以上である必要があります。

(PUNICODE_STRING)バッファー は、Unicode 形式でわかりやすいトレース名を指定します。

 *(PTRACEHANDLE)TraceInformation は、指定されたフレンドリ名に関連付けられているイベント トレース ハンドルに設定されます。
 

呼び出し元が RequiredLength ポインターNULL 以外の値を指定した場合、WmiQueryTraceInformation は、指定されたイベント トレース情報に必要な長さを返します。

WmiQueryTraceInformation は、呼び出し元の IRQL で実行されます。

必要条件

要件 価値
サポートされる最小クライアント Windows XP 以降のバージョンの Windows で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 「解説」セクションを参照してください。

関連項目

IoWmiWriteEvent の

TRACE_INFORMATION_CLASS

WmiFireEvent の

WmiTraceMessage

WmiTraceMessageVa