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
一或多個屬性，指出如何顯示此計數器。
可能的值包括：
屬性 PERF_ATTRIB_NO_GROUP_SEPARATOR、 PERF_ATTRIB_DISPLAY_AS_REAL和 PERF_ATTRIB_DISPLAY_AS_HEX 互斥。 如果您指定這三個屬性，優先順序會依指定的順序指定給屬性。
DetailLevel
計數器的目標物件。
可能的值包括：
| 值 | 意義 |
|---|---|
|
您可以將計數器顯示給任何層級的使用者。 |
|
計數器很複雜，應該只會顯示給進階使用者。 |
DefaultScale
要套用至原始效能計數器值的縮放比例。 有效值的範圍從 –10 到 10。 如果未套用縮放比例，則為零。 如果此值為零，小數位數值為 1;如果此值為 1，則刻度值為 10;如果此值為 –1，則小數位數值為 .10;依此類故。 效能計數器的縮放值等於效能計數器的原始值乘以 10 乘以 DefaultScale 成員所指定的電源。
BaseCounterId
基底計數器的計數器識別碼。 0xFFFFFFFF表示沒有基底計數器。
PerfTimeId
效能計數器的計數器識別碼。 0xFFFFFFFF表示沒有效能計數器。
PerfFreqId
頻率計數器的計數器識別碼。 0xFFFFFFFF表示沒有頻率計數器。
MultiId
多計數器的計數器識別碼。 0xFFFFFFFF表示沒有多計數器。
AggregateFunc
如果 ，用戶端應該套用至計數器的匯總函式
計數器所屬計數器所屬的計數器類型為全域匯總、多重
實例匯總或全域匯總歷程記錄。 如果計數器集合類型，用戶端會指定執行匯總的計數器實例
是多個實例匯總;否則，用戶端必須匯總值
跨計數器集的所有實例。 下列其中一個值必須是
指定。
| 值 | 意義 |
|---|---|
|
未定義。 |
|
傳回之計數器實例的值總和。 |
|
傳回之計數器實例之值的平均值。 |
|
傳回之計數器實例值的最小值。 |
|
傳回之計數器實例值的最大值。 |
Reserved
保留的。
備註
PerfQueryCounterSetRegistrationInfo函式，其 requestCode參數設定為PERF_REG_COUNTERSET_STRUCT取得包含一或多個PERF_COUNTER_REG_INFO結構的PERF_COUNTERSET_REG_INFO區塊。
PerfQueryCounterSetRegistrationInfo函式，其 requestCode參數設定為PERF_REG_COUNTER_STRUCT取得PERF_COUNTER_REG_INFO結構。
需求
| 最低支援的用戶端 | Windows 10 1607 版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 標頭 | perflib.h |