counter 複合型
- [アーティクル]
-
-
カウンターを定義します。
<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>
子要素
属性
| 名前 |
型 |
説明 |
| 集計 (aggregate) |
counterSet の instances 属性が globalAggregate、multipleAggregate、または globalAggregateHistory の場合に適用する集計関数。 適用できる集計関数を次に示します。
-
最大
- カウンターの最大値が返されます。
-
分
- 最小カウンター値が返されます。
-
平均
- 平均カウンター値が返されます。
-
合計
- カウンター値の合計が返されます。
-
未定義
- このカウンターを集計しないでください。
|
|
| baseID |
man:UInt32Type |
同じカウンター セット内の別のカウンターの識別子。その値は、このカウンターの値の計算に使用されます。 次のカウンターの種類には、ベース カウンターが必要です。
-
PERF_AVERAGE_TIMER
- PERF_AVERAGE_BASEベース カウンターが必要です。
-
PERF_AVERAGE_BULK
- PERF_AVERAGE_BASEベース カウンターが必要です。
-
PERF_COUNTER_MULTI_TIMER_INV
- PERF_COUNTER_MULTI_BASEベース カウンターが必要です。
-
PERF_LARGE_RAW_FRACTION
- PERF_LARGE_RAW_BASEベース カウンターが必要です。
-
PERF_PRECISION_100NS_TIMER
- PERF_LARGE_RAW_BASEベース カウンターが必要です。
-
PERF_RAW_FRACTION
- PERF_RAW_BASEベース カウンターが必要です。
-
PERF_SAMPLE_FRACTION
- PERF_SAMPLE_BASEベース カウンターが必要です。
|
| defaultScale |
カウンター値に適用するスケール係数 (係数 * カウンター値)。 スケールが適用されていない場合、既定値は 0 です。 有効な値の範囲は 10 から 10 (0.00000000001 から 10000000000) です。 この値が 0 の場合、スケール値は 1 になります。この値が 1 の場合、スケール値は 10 になります。この値が 1 の場合、スケール値は .10 になります。などなど。
|
|
| description |
xs:string |
カウンターの簡単な説明。 カウンターに noDisplay 属性が含まれている場合は、この属性を指定する必要はありません。
|
| detailLevel |
カウンターの詳細の対象ユーザーを指定します。 使用できる値を次に示します。
-
標準
- 一般的なユーザーが理解するカウンターの詳細を表示します。
-
詳細
- 上級ユーザーのみが理解するカウンターに関する詳細を表示します。
|
|
| フィールド |
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 |
ユーザーが任意の場所からカウンター値を取得できるようにする一意の UNIFORM リソース識別子。
|
下位互換性を提供するには、カウンター セット内の各カウンターで同じ perfFreqID 値と perfTimeID 値を 指定する必要があります。
要件
| 要件 |
値 |
サポートされている最小のクライアント
|
Windows Vista [デスクトップ アプリのみ]
|
サポートされている最小のサーバー
|
Windows Server 2008 [デスクトップ アプリのみ]
|