次の方法で共有


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>

子要素

要素 Type 説明
counterAttributes man:counterAttributes コンシューマー アプリケーションでのカウンター データの表示方法を指定する一意の属性を一覧表示します。

属性

名前 説明
集計 (aggregate) counterSetinstances 属性が 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 [デスクトップ アプリのみ]