PERF_COUNTERSET_REG_INFO 구조체(perflib.h)

구조를 포함하는 PERF_COUNTERSET_REG_INFO 블록에 대한 정보를 포함합니다. PERF_COUNTERSET_REG_INFO 블록은 카운터 집합 및 이 집합에 포함된 성능 카운터에 대한 등록 정보를 제공하며 PERF_COUNTERSET_REG_INFO 구조와 카운터 집합의 성능 카운터에 해당하는 집합 PERF_COUNTER_REG_INFO 구조로 구성됩니다.

구문

typedef struct _PERF_COUNTERSET_REG_INFO {
  GUID  CounterSetGuid;
  ULONG CounterSetType;
  ULONG DetailLevel;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_REG_INFO, *PPERF_COUNTERSET_REG_INFO;

멤버

CounterSetGuid

카운터 집합의 고유 식별자입니다.

CounterSetType

예약되어 있습니다.

DetailLevel

카운터 집합의 카운터에 대한 대상 그룹입니다.

가능한 값은 다음과 같습니다.

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

NumCounters

이 PERF_COUNTERSET_REG_INFO 블록의 PERF_COUNTER_REG_INFO 구조체 수입니다.

InstanceType

카운터 집합에 프로세스 및 실제 디스크와 같은 여러 인스턴스를 사용할 수 있는지 아니면 메모리와 같은 단일 인스턴스를 사용할 수 있는지를 지정합니다.

다음은 가능한 instance 형식입니다.

값	의미
PERF_COUNTERSET_SINGLE_INSTANCE	카운터 집합에 실제 메모리를 측정하는 카운터와 같은 단일 카운터 인스턴스가 들어 있습니다.
PERF_COUNTERSET_MULTI_INSTANCES	카운터 집합에 프로세스의 평균 디스크 I/O를 측정하는 카운터와 같은 여러 인스턴스 카운터가 들어 있습니다.
PERF_COUNTERSET_SINGLE_AGGREGATE	카운터 집합에 하나 이상의 소스에서 가져온 집계 값을 갖는 단일 인스턴스 카운터가 들어 있습니다. 예를 들어 이 형식의 카운터 집합에 있는 카운터는 컴퓨터에 있는 하드 디스크 세 대에서 읽은 바이트 수를 각각 가져와 모두 더할 수 있습니다.
PERF_COUNTERSET_MULTI_AGGREGATE	카운터 집합에 카운터의 모든 인스턴스에서 가져온 집계 값을 갖는 여러 인스턴스 카운터가 들어 있습니다. 예를 들어 이러한 유형의 카운터 집합에 있는 카운터는 다중 스레드 애플리케이션의 모든 스레드에 대한 총 스레드 실행 시간을 가져오고 해당 값을 합산할 수 있습니다.
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY	이 형식과 PERF_COUNTERSET_SINGLE_AGGREGATE 차이점은 이 카운터 집합 형식이 소비자 애플리케이션의 수명 동안 모든 카운터 값을 저장한다는 것입니다(카운터 값은 카운터의 수명을 초과하여 캐시됨). 예를 들어 위의 단일 집계 예제에서 하드 디스크 중 하나를 사용할 수 없게 되면 해당 디스크에서 읽은 총 바이트를 계속 사용할 수 있으며 집계 값을 계산하는 데 사용됩니다.
PERF_COUNTERSET_INSTANCE_AGGREGATE	구현되지 않았습니다.

설명

requestCode 매개 변수가 PERF_REG_COUNTERSET_STRUCT 설정된 상태에서 호출된 PerfQueryCounterSetRegistrationInfo 함수는 PERF_COUNTERSET_REG_INFO 블록을 가져옵니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1607 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
머리글	perflib.h