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까지입니다. 눈금이 적용되지 않으면 0입니다. 이 값이 0이면 배율 값은 1이고, 이 값이 1이면 배율 값은 10이고, 이 값이 –1이면 배율 값은 .10이고, 등등. 성능 카운터의 크기 조정된 값은 DefaultScale 멤버가 지정하는 전원에 10을 곱한 성능 카운터의 원시 값과 같습니다.
BaseCounterId
기본 카운터의 카운터 식별자입니다. 0xFFFFFFFF 기본 카운터가 없음을 나타냅니다.
PerfTimeId
성능 카운터의 카운터 식별자입니다. 0xFFFFFFFF 성능 카운터가 없음을 나타냅니다.
PerfFreqId
빈도 카운터의 카운터 식별자입니다. 0xFFFFFFFF 빈도 카운터가 없음을 나타냅니다.
MultiId
다중 카운터의 카운터 식별자입니다. 0xFFFFFFFF 다중 카운터가 없음을 나타냅니다.
AggregateFunc
클라이언트가 카운터에 적용해야 하는 집계 함수(있는 경우)
카운터가 속한 카운터 집합은 Global Aggregate, Multiple 형식입니다.
인스턴스 집계 또는 전역 집계 기록입니다. 클라이언트는 카운터 집합 형식인 경우 집계가 수행되는 카운터 인스턴스를 지정합니다.
은 다중 인스턴스 집계입니다. 그렇지 않으면 클라이언트는 값을 집계해야 합니다.
카운터 집합의 모든 인스턴스에 걸쳐 있습니다. 다음 값 중 하나여야 합니다.
지정.
Reserved
예약되어 있습니다.
설명
requestCode 매개 변수를 PERF_REG_COUNTERSET_STRUCT 설정하여 호출된 PerfQueryCounterSetRegistrationInfo 함수는 하나 이상의 PERF_COUNTER_REG_INFO 구조체가 포함된 PERF_COUNTERSET_REG_INFO 블록을 가져옵니다.
requestCode 매개 변수가 PERF_REG_COUNTER_STRUCT 설정된 상태에서 호출된 PerfQueryCounterSetRegistrationInfo 함수는 PERF_COUNTER_REG_INFO 구조를 가져옵니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 10 버전 1607 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 머리글 | perflib.h |