카운터 복합 형식
이 문서의 내용
카운터를 정의합니다.
<xs:complexType name="counter">
<xs:choice
minOccurs="0"
maxOccurs="1"
>
<xs:element name="counterAttributes"
type="man:counterAttributes"
>
<xs:key name="uniqueCounterAttributeName">
<xs:selector
xpath="./man:counterAttribute"
/>
<xs:field
xpath="@name"
/>
</xs:key>
</xs:element>
</xs:choice>
<xs:attribute name="symbol"
type="man:CSymbolType"
use="optional"
/>
<xs:attribute name="id"
type="man:UInt32Type"
use="required"
/>
<xs:attribute name="uri"
type="xs:anyURI"
use="required"
/>
<xs:attribute name="name"
use="optional"
>
<xs:simpleType>
<xs:restriction
base="xs:string"
>
<xs:maxLength
value="1023"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="description"
type="xs:string"
use="optional"
/>
<xs:attribute name="type"
use="required"
>
<xs:simpleType>
<xs:restriction
base="xs:string"
>
<xs:enumeration
value="perf_counter_counter"
/>
<xs:enumeration
value="perf_counter_timer"
/>
<xs:enumeration
value="perf_counter_queuelen_type"
/>
<xs:enumeration
value="perf_counter_large_queuelen_type"
/>
<xs:enumeration
value="perf_counter_100ns_queuelen_type"
/>
<xs:enumeration
value="perf_counter_obj_time_queuelen_type"
/>
<xs:enumeration
value="perf_counter_bulk_count"
/>
<xs:enumeration
value="perf_counter_text"
/>
<xs:enumeration
value="perf_counter_rawcount"
/>
<xs:enumeration
value="perf_counter_large_rawcount"
/>
<xs:enumeration
value="perf_counter_rawcount_hex"
/>
<xs:enumeration
value="perf_counter_large_rawcount_hex"
/>
<xs:enumeration
value="perf_sample_fraction"
/>
<xs:enumeration
value="perf_sample_counter"
/>
<xs:enumeration
value="perf_counter_timer_inv"
/>
<xs:enumeration
value="perf_sample_base"
/>
<xs:enumeration
value="perf_average_timer"
/>
<xs:enumeration
value="perf_average_base"
/>
<xs:enumeration
value="perf_average_bulk"
/>
<xs:enumeration
value="perf_obj_time_timer"
/>
<xs:enumeration
value="perf_100nsec_timer"
/>
<xs:enumeration
value="perf_100nsec_timer_inv"
/>
<xs:enumeration
value="perf_counter_multi_timer"
/>
<xs:enumeration
value="perf_counter_multi_timer_inv"
/>
<xs:enumeration
value="perf_counter_multi_base"
/>
<xs:enumeration
value="perf_100nsec_multi_timer"
/>
<xs:enumeration
value="perf_100nsec_multi_timer_inv"
/>
<xs:enumeration
value="perf_raw_fraction"
/>
<xs:enumeration
value="perf_large_raw_fraction"
/>
<xs:enumeration
value="perf_raw_base"
/>
<xs:enumeration
value="perf_large_raw_base"
/>
<xs:enumeration
value="perf_elapsed_time"
/>
<xs:enumeration
value="perf_counter_delta"
/>
<xs:enumeration
value="perf_counter_large_delta"
/>
<xs:enumeration
value="perf_precision_system_timer"
/>
<xs:enumeration
value="perf_precision_100ns_timer"
/>
<xs:enumeration
value="perf_precision_object_timer"
/>
<xs:enumeration
value="perf_counter_composite"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="baseID"
type="man:UInt32Type"
use="optional"
/>
<xs:attribute name="detailLevel"
use="required"
>
<xs:simpleType>
<xs:restriction
base="xs:string"
>
<xs:enumeration
value="standard"
/>
<xs:enumeration
value="advanced"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="defaultScale"
use="optional"
default="0"
>
<xs:simpleType>
<xs:restriction
base="xs:integer"
>
<xs:minInclusive
value="-10"
/>
<xs:maxInclusive
value="10"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="aggregate"
use="optional"
>
<xs:simpleType>
<xs:restriction
base="xs:string"
>
<xs:enumeration
value="sum"
/>
<xs:enumeration
value="avg"
/>
<xs:enumeration
value="max"
/>
<xs:enumeration
value="min"
/>
<xs:enumeration
value="undefined"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="perfTimeID"
type="man:UInt32Type"
use="optional"
/>
<xs:attribute name="perfFreqID"
type="man:UInt32Type"
use="optional"
/>
<xs:attribute name="multiCounterID"
type="man:UInt32Type"
use="optional"
/>
<xs:attribute name="struct"
type="man:CSymbolType"
use="optional"
/>
<xs:attribute name="field"
type="man:CSymbolType"
use="optional"
/>
</xs:complexType>
자식 요소
특성
이름
형식
Description
aggregate
counterSet 의 인스턴스 특성이 globalAggregate, multipleAggregate 또는 globalAggregateHistory인 경우 적용할 집계 함수입니다. 다음은 적용할 수 있는 가능한 집계 함수입니다.
최대 카운터 값이 반환됩니다.
최소 카운터 값이 반환됩니다.
평균 카운터 값이 반환됩니다.
카운터 값의 합계가 반환됩니다.
이 카운터를 집계하지 마세요.
baseID
man:UInt32Type
동일한 카운터 집합 내의 다른 카운터 식별자이며, 해당 값은 이 카운터의 값을 계산하는 데 사용됩니다. 다음 카운터 형식에는 기본 카운터가 필요합니다.
PERF_AVERAGE_BASE 기본 카운터가 필요합니다.
PERF_AVERAGE_BASE 기본 카운터가 필요합니다.
PERF_COUNTER_MULTI_BASE 기본 카운터가 필요합니다.
PERF_LARGE_RAW_BASE 기본 카운터가 필요합니다.
PERF_LARGE_RAW_BASE 기본 카운터가 필요합니다.
PERF_RAW_BASE 기본 카운터가 필요합니다.
PERF_SAMPLE_BASE 기본 카운터가 필요합니다.
defaultScale
카운터 값(factor * counter value)에 적용할 배율 인수입니다. 크기 조정이 적용되지 않으면 기본값은 0입니다. 유효한 값의 범위는 10에서 10(0.00000000001에서 10000000000)입니다. 이 값이 0이면 배율 값은 1이고, 이 값이 1이면 배율 값은 10이고, 이 값이 1이면 배율 값은 .10이고, 등등.
description
xs:string
카운터에 대한 간단한 설명입니다. 카운터에 noDisplay
detailLevel
카운터 세부 정보에 대한 대상 그룹을 지정합니다. 가능한 값은 다음과 같습니다.
일반적인 사용자가 이해할 수 있는 카운터에 대한 세부 정보를 표시합니다.
고급 사용자만 이해할 수 있는 카운터에 대한 세부 정보를 표시합니다.
필드(field)
man:CSymbolType
카운터 값이 포함된 구조체 내의 필드 이름입니다. 이 특성은 사용자 모드 공급자에 대해 허용되지 않습니다.
id
man:UInt32Type
카운터 집합 내에서 카운터를 식별하는 고유 번호입니다.
multiCounterID
man:UInt32Type
이 카운터의 값을 계산하는 데 승수 값을 사용하는 동일한 카운터 집합 내의 다른 카운터 식별자입니다. 다음 카운터 형식에는 승수 값이 필요합니다. 참조된 카운터는 PERF_COUNTER_RAWCOUNT 형식이어야 합니다.PERF_COUNTER_MULTI_TIMER PERF_COUNTER_MULTI_TIMER_INV PERF_100NSEC_MULTI_TIMER PERF_100NSEC_MULTI_TIMER_INV
name
카운터의 이름입니다. 이름은 고유하고 1,024자 미만이어야 합니다. 이름은 대/소문자를 구분합니다. 카운터에 noDisplay
perfFreqID
man:UInt32Type
이 카운터의 값을 계산하는 데 빈도 값을 사용하는 동일한 카운터 집합 내의 다른 카운터 식별자입니다. 다음 카운터 형식에는 빈도가 필요합니다. PERF_COUNTER_LARGE_RAWCOUNT 카운터 형식에는 타임스탬프를 포함합니다.PERF_COUNTER_OBJECT_TIME_QUEUELEN_TYPE PERF_ELAPSED_TIME PERF_OBJ_TIME_TIMER PERF_PRECISION_OBJECT_TIMER
perfTimeID
man:UInt32Type
이 카운터의 값을 계산하는 데 타임스탬프를 사용하는 동일한 카운터 집합 내의 다른 카운터 식별자입니다. 다음 카운터 형식에는 타임스탬프를 요구합니다. PERF_COUNTER_LARGE_RAWCOUNT 카운터 형식에는 타임스탬프를 포함합니다.PERF_COUNTER_OBJECT_TIME_QUEUELEN_TYPE PERF_ELAPSED_TIME PERF_OBJ_TIME_TIMER PERF_PRECISION_OBJECT_TIMER
struct
man:CSymbolType
이 카운터 값을 포함하는 구조체 요소의 이름입니다. 이 특성은 사용자 모드 공급자에 대해 허용되지 않습니다.
기호
man:CSymbolType
카운터를 식별하는 기호 이름입니다.
CTRPP 도구는 카운터 식별자가 필요한 함수를 호출할 때 사용할 수 있는 상수를 만듭니다(예: PerfIncrementULongCounterValue
형식
카운터 형식의 이름입니다. 가능한 값은 위의 구문 블록을 참조하세요. 각 형식에 대한 자세한 내용은 Windows 2003 배포 가이드의 카운터 형식 을 참조하세요. 이름은 대/소문자 구분 사용 소문자입니다.
uri
xs:anyURI
사용자가 모든 위치에서 카운터 값을 검색할 수 있는 고유한 균일한 리소스 식별자입니다.
이전 버전과의 호환성을 제공하려면 카운터 집합의 각 카운터에서 동일한 perfFreqID 및 perfTimeID 값을 지정해야 합니다.
요구 사항
요구 사항
값
지원되는 최소 클라이언트
Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
Windows Server 2008 [데스크톱 앱만 해당]