PERF_COUNTERSET_REG_INFO 構造体 (perflib.h)

  • [アーティクル]

構造体を含む PERF_COUNTERSET_REG_INFO ブロックに関する情報を格納します。 PERF_COUNTERSET_REG_INFO ブロックは、カウンター セットとそれに含まれるパフォーマンス カウンターの登録情報を提供し、PERF_COUNTERSET_REG_INFO構造体の直後に、カウンター セット内のパフォーマンス カウンターに対応するセット PERF_COUNTER_REG_INFO構造体で構成されます。

構文

typedef struct _PERF_COUNTERSET_REG_INFO {
  GUID  CounterSetGuid;
  ULONG CounterSetType;
  ULONG DetailLevel;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_REG_INFO, *PPERF_COUNTERSET_REG_INFO;

メンバー

CounterSetGuid

カウンター セットの一意識別子。

CounterSetType

予約済み。

DetailLevel

カウンター セット内のカウンターの対象ユーザー。

次の値を指定できます。

値 意味
PERF_DETAIL_NOVICE
 カウンターは、任意のレベルのユーザーに表示できます。
PERF_DETAIL_ADVANCED
 カウンターは複雑であり、上級ユーザーにのみ表示する必要があります。

NumCounters

この PERF_COUNTERSET_REG_INFO ブロック内の PERF_COUNTER_REG_INFO 構造体の数。

InstanceType

カウンター セットで、プロセスや物理ディスクのような複数インスタンスを許可するか、メモリのような単一インスタンスに制限するかを指定します。

使用できるインスタンスの種類を次に示します。

値 意味
PERF_COUNTERSET_SINGLE_INSTANCE
 カウンター セットは、単一インスタンスのカウンター (物理メモリを測定するカウンターなど) を含みます。
PERF_COUNTERSET_MULTI_INSTANCES
 カウンター セットは、複数インスタンスのカウンター (プロセスに対するディスク I/O の平均を測定するカウンターなど) を含みます。
PERF_COUNTERSET_SINGLE_AGGREGATE
 カウンター セットは、1 つ以上のソースから集計値が取得される単一インスタンスのカウンターを含みます。 たとえば、この種類のカウンター セットのカウンターでは、コンピューターの 3 つのハード ディスクのそれぞれから読み取り回数を取得し、それらの値を合計できます。
PERF_COUNTERSET_MULTI_AGGREGATE
 カウンター セットは、カウンターのすべてのインスタンスから集計値が取得される複数インスタンスのカウンターを含みます。 たとえば、この種類のカウンター セット内のカウンターは、マルチスレッド アプリケーション内のすべてのスレッドの合計スレッド実行時間を取得し、その値を合計する場合があります。
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY
 この型と PERF_COUNTERSET_SINGLE_AGGREGATE の違いは、このカウンター セット型はコンシューマー アプリケーションの有効期間中のすべてのカウンター値を格納することです (カウンター値はカウンターの有効期間を超えてキャッシュされます)。 たとえば、上記の 1 つの集計例のハード ディスクのいずれかが使用できなくなった場合でも、そのディスクによって読み取られた合計バイト数は引き続き使用でき、集計値の計算に使用されます。
PERF_COUNTERSET_INSTANCE_AGGREGATE
 実装されていません。

注釈

requestCode パラメーターを に設定して呼び出された PerfQueryCounterSetRegistrationInfo 関数PERF_REG_COUNTERSET_STRUCTPERF_COUNTERSET_REG_INFO ブロックを取得します。

要件

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