PERF_COUNTER_HEADER 構造体 (perflib.h)

  • [アーティクル]

構造体を含む PERF_COUNTER_HEADER ブロックに関する情報を格納します。 PERF_COUNTER_HEADER ブロックは、パフォーマンス カウンター クエリのエラー情報とデータを提供し、PERF_COUNTER_HEADER構造の後に追加のパフォーマンス カウンター データで構成されます。

構文

typedef struct _PERF_COUNTER_HEADER {
  ULONG               dwStatus;
  PerfCounterDataType dwType;
  ULONG               dwSize;
  ULONG               Reserved;
} PERF_COUNTER_HEADER, *PPERF_COUNTER_HEADER;

メンバー

dwStatus

パフォーマンスを照会する操作が成功したか失敗したかを示すエラー コード。

dwType

PERF_COUNTER_HEADER ブロックが提供するパフォーマンス カウンター情報の種類。

値 説明
PERF_ERROR_RETURN
 パフォーマンス カウンター クエリの結果であるエラー。 パフォーマンス ライブラリは、プロバイダーから有効なカウンター データを取得できません。 PERF_COUNTER_HEADER構造に続く追加データはありません。 構造体の dwStatus メンバーには、エラー コードが含まれています。
PERF_SINGLE_COUNTER
 単一カウンターの単一インスタンス クエリの結果。たとえば、"\Processor(_Total)\% Processor Time" などです。 追加データは 、PERF_COUNTER_DATA ブロックで構成されます。
PERF_MULTIPLE_COUNTERS
 マルチカウンターの単一インスタンス クエリの結果。たとえば、"\Processor(_Total)\*" などです。 追加データは、PERF_MULTI_COUNTERS ブロックの後 に PERF_COUNTER_DATAブロックが 続くもので構成されます。
PERF_MULTIPLE_INSTANCES
 単一カウンターのマルチインスタンス クエリの結果。たとえば、"\Processor(*)\% Processor Time" などです。 追加データは 、PERF_MULTI_INSTANCES ブロックで構成されます。
PERF_COUNTERSET
 マルチカウンター、マルチインスタンス クエリの結果。たとえば、"\Processor(*)\*" などです。 追加データは、 PERF_MULTI_COUNTERS ブロックの後に PERF_MULTI_INSTANCES ブロックが続きます。

dwSize

PERF_COUNTER_HEADER ブロックの合計サイズ。これは、PERF_COUNTER_HEADER構造体のサイズと追加データのサイズの合計と等しくなります。

Reserved

予約済み。

解説

PerfQueryCounterData 関数は、PERF_COUNTER_HEADER ブロックのシーケンスを含むPERF_DATA_HEADER ブロックを返します。

要件

   
サポートされている最小のクライアント Windows 10、バージョン 1607 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
Header perflib.h

関連項目

PERF_COUNTER_DATA

PERF_MULTI_COUNTERS

PERF_MULTI_INSTANCES

PerfCounterDataType