counter 複合型

[アーティクル]
06/12/2023

カウンターを定義します。

<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)	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 [デスクトップアプリのみ]

次の方法で共有

counter 複合型

子要素

属性

注釈

要件

フィードバック

その他のリソース