다음을 통해 공유

PERF_COUNTERSET_INFO 구조체(perflib.h)

  • 아티클

공급자가 사용하는 카운터 집합에 대한 정보를 정의합니다. CTRPP 도구는 지정한 스키마에 따라 이 구조를 자동으로 생성합니다.

구문

typedef struct _PERF_COUNTERSET_INFO {
  GUID  CounterSetGuid;
  GUID  ProviderGuid;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_INFO, *PPERF_COUNTERSET_INFO;

멤버

CounterSetGuid

카운터 집합을 고유하게 식별하는 GUID입니다. counterSet 요소의 guid 특성에는 GUID가 포함됩니다.

ProviderGuid

카운터 집합을 지원하는 공급자를 고유하게 식별하는 GUID입니다. 공급자 요소의 providerGuid 특성에는 GUID가 포함됩니다.

NumCounters

카운터 집합의 카운터 수입니다. 설명 부분을 참조하세요.

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
 이 형식은 모든 instance 데이터를 하나의 집계된(_Total) instance 집계하는 대신 동일한 이름의 인스턴스에서 카운터 데이터를 집계한다는 점을 제외하고 PERF_COUNTERSET_MULTI_AGGREGATE 비슷합니다.

예를 들어 여러 공급자 프로세스에 IExplore, PERF_COUNTERSET_MULTIPLE 및 PERF_COUNTERSET_MULTI_AGGREGATE CounterSet이라는 인스턴스가 포함된 경우 여러 IExplore 인스턴스(IExplore, IExplore#1, IExplore#2 등)가 표시됩니다. 그러나 PERF_COUNTERSET_INSTANCE_AGGREGATE instance 형식은 IExplore라는 모든 인스턴스의 집계된 카운터 데이터를 사용하여 하나의 IExplore instance 게시합니다.

Windows Vista: 이 형식은 사용할 수 없습니다.

설명

이 구조체의 메모리 블록에는 하나 이상의 PERF_COUNTER_INFO 구조체도 포함되어 있습니다. NumCounter 멤버는 메모리에서 이 구조체를 따르는 PERF_COUNTER_INFO 구조체의 수를 결정합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 perflib.h

추가 정보

PERF_COUNTER_INFO

PerfSetCounterSetInfo