perflib.h (PERF_COUNTER_IDENTIFIER 結構)
包含包含結構 之PERF_COUNTER_IDENTIFIER 區塊的相關信息。 PERF_COUNTER_IDENTIFIER 區塊提供性能計數器規格的相關信息,並依序包含下列專案:
- PERF_COUNTER_IDENTIFIER 結構
- 指定實例名稱的選擇性 Null 終止 UTF-16LE 字串
- 視需要填補,使區塊的大小成為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 成員中指出查詢取得結果的順序。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1607 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
標頭 | perflib.h |