perflib.h (PERF_COUNTER_IDENTIFIER 結構)

包含包含結構 之PERF_COUNTER_IDENTIFIER 區塊的相關信息。 PERF_COUNTER_IDENTIFIER 區塊提供性能計數器規格的相關信息，並依序包含下列專案：

1. PERF_COUNTER_IDENTIFIER 結構
2. 指定實例名稱的選擇性 Null 終止 UTF-16LE 字串
3. 視需要填補，使區塊的大小成為8個字節的倍數。

語法

typedef struct _PERF_COUNTER_IDENTIFIER {
  GUID  CounterSetGuid;
  ULONG Status;
  ULONG Size;
  ULONG CounterId;
  ULONG InstanceId;
  ULONG Index;
  ULONG Reserved;
} PERF_COUNTER_IDENTIFIER, *PPERF_COUNTER_IDENTIFIER;

成員

CounterSetGuid

性能計數器集的 GUID 。

Status

錯誤碼，指出要新增或刪除性能計數器的作業是否成功或失敗。

Size

PERF_COUNTER_IDENTIFIER 區塊的大小 總計，以位元組為單位。 區塊的大小總計是 PERF_COUNTER_IDENTIFIER 結構的大小總和、指定實例名稱和填補的字串。

CounterId

性能計數器的標識碼。 PERF_WILDCARD_COUNTER 指定所有計數器。

InstanceId

執行個體識別碼。 如果您不想根據實例標識碼篩選結果，請指定0xFFFFFFFF。

Index

傳回對應至此PERF_COUNTER_IDENTIFIER區塊之計數器數據之PERF_COUNTER_IDENTIFIER區塊序列中的位置。 由 PerfQueryCounterInfo 設定。

Reserved

保留的。

備註

當您指定單一實例計數器集的計數器集標識符時，您不得在 PERF_COUNTER_IDENTIFIER 區塊的其他數據中指定實例名稱。 PERF_COUNTER_IDENTIFIER區塊的大小必須是PERF_COUNTER_IDENTIFIER結構的大小。

另一方面，當您指定多個實例計數器集的計數器集標識碼時，您必須在 PERF_COUNTER_IDENTIFIER 區塊的其他數據中指定實例名稱。 除非 PERF_COUNTER_IDENTIFIER 區塊的大小大於 PERF_COUNTER_IDENTIFIER 結構的大小，否則標識符無效。 如果您不想根據實例名稱篩選計數器集合，請使用 PERF_WILDCARD_INSTANCE 作為實例名稱。

PerfAddCounters 和 PerfDeleteCounters 函式接受一連串的PERF_COUNTER_IDENTIFIER區塊，以定義您要從查詢新增或移除的計數器規格。

PerfQueryCounterInfo 函式會取得一連串的PERF_COUNTER_IDENTIFIER區塊，以指出查詢中的計數器規格，並在 Index 成員中指出查詢取得結果的順序。

規格需求

另請參閱

PerfAddCounters

PerfDeleteCounters

PerfQueryCounterInfo