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_COUNTER_HEADER構造に続く追加データはありません。 構造体の dwStatus メンバーには、エラー コードが含まれています。 |
|
単一カウンターの単一インスタンス クエリの結果。たとえば、"\Processor(_Total)\% Processor Time" などです。 追加データは 、PERF_COUNTER_DATA ブロックで構成されます。 |
|
マルチカウンターの単一インスタンス クエリの結果。たとえば、"\Processor(_Total)\*" などです。 追加データは、PERF_MULTI_COUNTERS ブロックの後 に PERF_COUNTER_DATAブロックが 続くもので構成されます。 |
|
単一カウンターのマルチインスタンス クエリの結果。たとえば、"\Processor(*)\% Processor Time" などです。 追加データは 、PERF_MULTI_INSTANCES ブロックで構成されます。 |
|
マルチカウンター、マルチインスタンス クエリの結果。たとえば、"\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 |