Lists the unique attributes that specify how the counter data is displayed in a consumer application.
Attributes
Name
Type
Description
aggregate
The aggregation function to apply if the instances attribute of counterSet is globalAggregate, multipleAggregate, or globalAggregateHistory. The following are the possible aggregation functions that you can apply:
The identifier of another counter within the same counter set, whose value is used to calculate this counter's value. The following counter types require a base counter:
PERF_AVERAGE_TIMER
Requires the PERF_AVERAGE_BASE base counter.
PERF_AVERAGE_BULK
Requires the PERF_AVERAGE_BASE base counter.
PERF_COUNTER_MULTI_TIMER_INV
Requires the PERF_COUNTER_MULTI_BASE base counter.
PERF_LARGE_RAW_FRACTION
Requires the PERF_LARGE_RAW_BASE base counter.
PERF_PRECISION_100NS_TIMER
Requires the PERF_LARGE_RAW_BASE base counter.
PERF_RAW_FRACTION
Requires the PERF_RAW_BASE base counter.
PERF_SAMPLE_FRACTION
Requires the PERF_SAMPLE_BASE base counter.
defaultScale
The scale factor to apply to the counter value (factor * counter value). The default is zero if no scale is applied. Valid values range from 10 to 10 (0.0000000001 to 1000000000). If this value is zero, the scale value is 1; if this value is 1, the scale value is 10; if this value is 1, the scale value is .10; and so on.
description
xs:string
A short description of the counter. You do not have to specify this attribute if the counter includes the noDisplay attribute.
detailLevel
Specifies the target audience for the counter details. The following are the possible values:
standard
Display details about the counter that a typical user would understand.
advanced
Display details about the counter that only an advanced user would understand.
The identifier of another counter within the same counter set, whose multiplier value is used to calculate this counter's value. The following counter types require a multiplier value. The referenced counter must be of type PERF_COUNTER_RAWCOUNT.
PERF_COUNTER_MULTI_TIMER
PERF_COUNTER_MULTI_TIMER_INV
PERF_100NSEC_MULTI_TIMER
PERF_100NSEC_MULTI_TIMER_INV
name
The name of the counter. The name must be unique and less than 1,024 characters. The name is case-sensitive. You do not have to specify this attribute if the counter includes the noDisplay attribute.
The identifier of another counter within the same counter set, whose frequency value is used to calculate this counter's value. The following counter types require a frequency. The PERF_COUNTER_LARGE_RAWCOUNT counter type contains the time stamp value.
The identifier of another counter within the same counter set, whose time stamp value is used to calculate this counter's value. The following counter types require a time stamp. The PERF_COUNTER_LARGE_RAWCOUNT counter type contains the time stamp value.
A symbolic name that identifies the counter. The CTRPP tool creates a constant that you can use when calling functions that require a counter identifier (for example, PerfIncrementULongCounterValue). The name of the constant is the symbolic name.
type
The name of the counter type. For possible values, see the above syntax block. For details of each type, see Counter Types in the Windows 2003 Deployment Guide. The name is case-sensitive use lowercase.
uri
xs:anyURI
A unique uniform resource identifier that lets users retrieve counter values from any location.
Remarks
To provide backwards-compatibility, each counter in the counter set should specify the same perfFreqID and perfTimeID values.