PERF_COUNTER_IDENTIFIER 구조체(perflib.h)
구조체를 포함하는 PERF_COUNTER_IDENTIFIER 블록에 대한 정보를 포함합니다. PERF_COUNTER_IDENTIFIER 블록은 성능 카운터 사양에 대한 정보를 제공하며 순서대로 다음 항목으로 구성됩니다.
- PERF_COUNTER_IDENTIFIER 구조체
- instance 이름을 지정하는 선택적 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 구조체의 크기, instance 이름을 지정하는 문자열 및 안쪽 여백의 합계입니다.
CounterId
성능 카운터의 식별자입니다. PERF_WILDCARD_COUNTER 모든 카운터를 지정합니다.
InstanceId
인스턴스 식별자입니다. instance 식별자를 기반으로 결과를 필터링하지 않으려면 0xFFFFFFFF 지정합니다.
Index
이 PERF_COUNTER_IDENTIFIER 블록에 해당하는 카운터 데이터가 반환되는 PERF_COUNTER_IDENTIFIER 블록 시퀀스의 위치입니다. PerfQueryCounterInfo로 설정합니다.
Reserved
예약되어 있습니다.
설명
단일 instance 카운터 집합에 대한 카운터 집합 식별자를 지정하는 경우 PERF_COUNTER_IDENTIFIER 블록의 추가 데이터에 instance 이름을 지정해서는 안 됩니다. PERF_COUNTER_IDENTIFIER 블록의 크기는 PERF_COUNTER_IDENTIFIER 구조체의 크기여야 합니다.
반면 다중 instance 카운터 집합에 대한 카운터 집합 식별자를 지정하는 경우 PERF_COUNTER_IDENTIFIER 블록의 추가 데이터에 instance 이름을 지정해야 합니다. PERF_COUNTER_IDENTIFIER 블록의 크기가 PERF_COUNTER_IDENTIFIER구조체 의 크기보다 크지 않으면 식별자가 유효하지 않습니다. instance 이름을 기준으로 카운터 집합을 필터링하지 않으려면 PERF_WILDCARD_INSTANCE instance 이름으로 사용합니다.
PerfAddCounters 및 PerfDeleteCounters 함수는 PERF_COUNTER_IDENTIFIER 블록 시퀀스를 수락하여 쿼리에서 추가하거나 제거할 카운터 사양을 정의합니다.
PerfQueryCounterInfo 함수는 쿼리의 카운터 사양을 나타내고 인덱스 멤버에 쿼리가 결과를 가져오는 순서를 나타내는 PERF_COUNTER_IDENTIFIER 블록 시퀀스를 가져옵니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1607 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 머리글 | perflib.h |