perflib.h) (結構PERF_COUNTERSET_REG_INFO

包含包含結構 之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

指定計數器集合可允許多重執行個體 (Instance)，例如處理序 (Process) 和實體磁碟，還是單一執行個體 (例如記憶體)。

以下是可能的實例類型。

值	意義
PERF_COUNTERSET_SINGLE_INSTANCE	計數器集合包含單一執行個體計數器，例如測量實體記憶體的計數器。
PERF_COUNTERSET_MULTI_INSTANCES	計數器集合包含多重執行個體計數器，例如測量處理序之平均磁碟 I/O 的計數器。
PERF_COUNTERSET_SINGLE_AGGREGATE	計數器集合包含單一執行個體計數器，而該計數器的彙總值是取自一個或多個來源。 例如，這種計數器集合型別中的計數器可以取得電腦中三個硬碟各自的讀取次數，並將它們的值加總。
PERF_COUNTERSET_MULTI_AGGREGATE	計數器集合包含多重執行個體計數器，而這些計數器的彙總值是取自計數器的所有執行個體。 例如，這種計數器集合中的計數器可能會取得多線程應用程式中所有線程的總線程運行時間，並加總其值。
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY	此類型與 PERF_COUNTERSET_SINGLE_AGGREGATE 之間的差異在於，此計數器集類型會儲存取用者應用程式存留期的所有計數器值， (計數器值快取超過計數器) 存留期。 例如，如果上述單一匯總範例中的其中一個硬碟變成無法使用，該磁碟所讀取的總位元組仍然可以使用，並用來計算匯總值。
PERF_COUNTERSET_INSTANCE_AGGREGATE	未實作。

備註

PerfQueryCounterSetRegistrationInfo 函式，其 requestCode 參數設定為 PERF_REG_COUNTERSET_STRUCT取得PERF_COUNTERSET_REG_INFO區塊。

規格需求

需求	值
最低支援的用戶端	Windows 10 版本 1607 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2016 [僅限傳統型應用程式]
標頭	perflib.h