PERF_COUNTER_REG_INFO構造体 (perflib.h)

  • [アーティクル]

パフォーマンス カウンターに関する登録情報を提供します。

構文

typedef struct _PERF_COUNTER_REG_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     DetailLevel;
  LONG      DefaultScale;
  ULONG     BaseCounterId;
  ULONG     PerfTimeId;
  ULONG     PerfFreqId;
  ULONG     MultiId;
  ULONG     AggregateFunc;
  ULONG     Reserved;
} PERF_COUNTER_REG_INFO, *PPERF_COUNTER_REG_INFO;

メンバー

CounterId

カウンター セット内のパフォーマンス カウンターの一意識別子。 カウンター セットには、最大 64,000 個のパフォーマンス カウンターを含めることができます。

Type

パフォーマンス カウンターの種類。 定義済みのカウンターの種類の詳細については、 Windows Server 2003 展開キットのカウンターの種類に関するセクションを参照してください。 コンシューマーはカウンターの種類を使用して、カウンター値を計算して表示する方法を決定します。 プロバイダーは、カウンターの種類の選択を定義済みのリストに制限する必要があります。

次の値を指定できます。

PERF_100NSEC_MULTI_TIMER

PERF_100NSEC_MULTI_TIMER_II

PERF_100NSEC_TIMER

PERF_100NSEC_TIMER_INV

PERF_AVERAGE_BASE

PERF_AVERAGE_BULK

PERF_AVERAGE_TIMER

PERF_COUNTER_100NS_QUEUELEN_TYPE

PERF_COUNTER_BULK_COUNT

PERF_COUNTER_COUNTER

PERF_COUNTER_DELTA

PERF_COUNTER_LARGE_DELTA

PERF_COUNTER_LARGE_QUEUELEN_TYPE

PERF_COUNTER_LARGE_RAWCOUNT

PERF_COUNTER_LARGE_RAWCOUNT_HEX

PERF_COUNTER_MULTI_TIMER

PERF_COUNTER_MULTI_TIMER_INV

PERF_COUNTER_OBJ_QUEUELEN_TYPE

PERF_COUNTER_RAWCOUNT

PERF_COUNTER_RAWCOUNT_HEX

PERF_COUNTER_TEXT

PERF_COUNTER_TIMER

PERF_COUNTER_TIMER_INV

PERF_ELAPSED_TIME

PERF_LARGE_RAW_BASE

PERF_OBJ_TIME_TIMER

PERF_PRECISION_100NS_TIMER

PERF_PRECISION_TIMER

PERF_PRECISION_OBJECT_TIMER

PERF_RAW_BASE

PERF_RAW_FRACTION

PERF_SAMPLE_COUNTER

PERF_SAMPLE_FRACTION

Attrib

このカウンターの表示方法を示す 1 つ以上の属性。

次の値を指定できます。

値 説明
PERF_ATTRIB_BY_REFERENCE
 値ではなく、参照によってカウンターの値を取得します。
PERF_ATTRIB_NO_DISPLAYABLE
 カウンター値は表示しません。
PERF_ATTRIB_NO_GROUP_SEPARATOR
 カウンター値を表示する場合は、桁区切り記号を使用しないでください。
PERF_ATTRIB_DISPLAY_AS_REAL
 カウンター値を実際の値として表示します。
PERF_ATTRIB_DISPLAY_AS_HEX
 カウンター値を 16 進数で表示します。
 

属性 PERF_ATTRIB_NO_GROUP_SEPARATOR、 PERF_ATTRIB_DISPLAY_AS_REAL、 およびPERF_ATTRIB_DISPLAY_AS_HEX は相互に排他的ではありません。 3 つの属性すべてを指定すると、属性に優先順位が指定された順序で指定されます。

DetailLevel

カウンターの対象ユーザー。

次の値を指定できます。

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

DefaultScale

生のパフォーマンス カウンター値に適用するスケーリング係数。 有効な値の範囲は –10 から 10 です。 スケールが適用されていない場合は 0。 この値が 0 の場合、スケール値は 1 になります。この値が 1 の場合、スケール値は 10 になります。この値が –1 の場合、スケール値は .10 になります。などなど。 パフォーマンス カウンターのスケーリングされた値は、パフォーマンス カウンターの生の値に、 DefaultScale メンバーが指定する累乗に 10 を乗算した値と等しくなります。

BaseCounterId

ベース カウンターのカウンター識別子。 0xFFFFFFFFは、ベース カウンターがないことを示します。

PerfTimeId

パフォーマンス カウンターのカウンター識別子。 0xFFFFFFFFは、パフォーマンス カウンターがないことを示します。

PerfFreqId

頻度カウンターのカウンター識別子。 0xFFFFFFFFは、周波数カウンターがないことを示します。

MultiId

マルチカウンターのカウンター識別子。 0xFFFFFFFFは、マルチカウンターがないことを示します。

AggregateFunc

クライアントがカウンターに適用する集計関数は、

カウンターが属するカウンター セットの種類はグローバル集計、複数

インスタンス集計、またはグローバル集計履歴。 クライアントは、カウンター セットの種類が指定されている場合に集計を実行するカウンター インスタンスを指定します

は複数インスタンス集計です。それ以外の場合、クライアントは値を集計する必要があります

カウンター セットのすべてのインスタンスに対して。 次のいずれかの値を指定する必要があります。

指定。

値 説明
PERF_AGGREGATE_UNDEFINED
 未定義です。
PERF_AGGREGATE_TOTAL
 返されるカウンター インスタンスの値の合計。
PERF_AGGREGATE_AVG
 返されるカウンター インスタンスの値の平均。
PERF_AGGREGATE_MIN
 返されるカウンター インスタンス値の最小値。
PERF_AGGREGATE_MAX
返されるカウンター インスタンス値の最大値。

Reserved

予約済み。

解説

requestCode パラメーターを PERF_REG_COUNTERSET_STRUCT に設定して呼び出された PerfQueryCounterSetRegistrationInfo 関数は、1 つ以上のPERF_COUNTER_REG_INFO構造体を含むPERF_COUNTERSET_REG_INFO ブロックを取得します。

requestCode パラメーターを に設定して呼び出された PerfQueryCounterSetRegistrationInfo 関数PERF_REG_COUNTER_STRUCTPERF_COUNTER_REG_INFO構造体を取得します。

要件

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

関連項目

PERF_COUNTERSET_REG_INFO

PerfQueryCounterSetRegistrationInfo