Share via

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_BY_REFERENCE
 값이 아닌 참조로 카운터의 값을 검색합니다.
PERF_ATTRIB_NO_DISPLAYABLE
 카운터 값을 표시하지 마세요.
PERF_ATTRIB_NO_GROUP_SEPARATOR
 카운터 값을 표시할 때는 숫자 구분 기호를 사용하지 마세요.
PERF_ATTRIB_DISPLAY_AS_REAL
 카운터 값을 실제 값으로 표시합니다.
PERF_ATTRIB_DISPLAY_AS_HEX
 카운터 값을 16진수로 표시합니다.
 

PERF_ATTRIB_NO_GROUP_SEPARATOR, PERF_ATTRIB_DISPLAY_AS_REAL 및 PERF_ATTRIB_DISPLAY_AS_HEX 특성은 상호 배타적이지 않습니다. 세 가지 특성을 모두 지정하면 지정된 순서대로 특성에 우선 순위가 지정됩니다.

DetailLevel

카운터의 대상 그룹입니다.

사용 가능한 값은

값 의미
PERF_DETAIL_NOVICE
 모든 수준의 사용자에 대한 카운터를 표시할 수 있습니다.
PERF_DETAIL_ADVANCED
 카운터는 복잡하며 고급 사용자에게만 표시되어야 합니다.

DefaultScale

원시 성능 카운터 값에 적용할 크기 조정 요소입니다. 유효한 값의 범위는 –10에서 10까지입니다. 눈금이 적용되지 않으면 0입니다. 이 값이 0이면 배율 값은 1이고, 이 값이 1이면 배율 값은 10이고, 이 값이 –1이면 배율 값은 .10이고, 등등. 성능 카운터의 크기 조정된 값은 DefaultScale 멤버가 지정하는 전원에 10을 곱한 성능 카운터의 원시 값과 같습니다.

BaseCounterId

기본 카운터의 카운터 식별자입니다. 0xFFFFFFFF 기본 카운터가 없음을 나타냅니다.

PerfTimeId

성능 카운터의 카운터 식별자입니다. 0xFFFFFFFF 성능 카운터가 없음을 나타냅니다.

PerfFreqId

빈도 카운터의 카운터 식별자입니다. 0xFFFFFFFF 빈도 카운터가 없음을 나타냅니다.

MultiId

다중 카운터의 카운터 식별자입니다. 0xFFFFFFFF 다중 카운터가 없음을 나타냅니다.

AggregateFunc

클라이언트가 카운터에 적용해야 하는 집계 함수(있는 경우)

카운터가 속한 카운터 집합은 Global Aggregate, Multiple 형식입니다.

인스턴스 집계 또는 전역 집계 기록입니다. 클라이언트는 카운터 집합 형식인 경우 집계가 수행되는 카운터 인스턴스를 지정합니다.

은 다중 인스턴스 집계입니다. 그렇지 않으면 클라이언트는 값을 집계해야 합니다.

카운터 집합의 모든 인스턴스에 걸쳐 있습니다. 다음 값 중 하나여야 합니다.

지정.

값 의미
PERF_AGGREGATE_UNDEFINED
 정의되지 않았습니다.
PERF_AGGREGATE_TOTAL
 반환된 카운터 인스턴스 값의 합계입니다.
PERF_AGGREGATE_AVG
 반환된 카운터 인스턴스 값의 평균입니다.
PERF_AGGREGATE_MIN
 반환된 카운터 instance 값의 최소값입니다.
PERF_AGGREGATE_MAX
반환된 카운터 instance 값의 최대값입니다.

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

추가 정보

PERF_COUNTERSET_REG_INFO

PerfQueryCounterSetRegistrationInfo