Freigeben über

Indikatorenkomplexer Typ

  • Artikel

Definiert einen Leistungsindikator.

<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>

Untergeordnete Elemente

Element type Beschreibung
counterAttributes man:counterAttributes Listet die eindeutigen Attribute auf, die angeben, wie die Zählerdaten in einer Consumeranwendung angezeigt werden.

Attributes

Name type Beschreibung
aggregate Die Aggregationsfunktion , die angewendet werden soll, wenn das Instanz-Attribut von counterSet globalAggregate, multipleAggregate oder globalAggregateHistory ist. Im Folgenden sind die möglichen Aggregationsfunktionen aufgeführt, die Sie anwenden können:
Max
Der maximale Zählerwert wird zurückgegeben.
Min
Der minimale Zählerwert wird zurückgegeben.
Avg
Der durchschnittliche Zählerwert wird zurückgegeben.
Summe
Die Summe der Zählerwerte wird zurückgegeben.
Undefined
Aggregieren Sie diesen Indikator nicht.
baseID man:UInt32Type Der Bezeichner eines anderen Zählers innerhalb desselben Zählersatzes, dessen Wert zum Berechnen des Werts dieses Indikators verwendet wird. Für die folgenden Leistungsindikatorentypen ist ein Basisindikator erforderlich:
PERF_AVERAGE_TIMER
Erfordert den PERF_AVERAGE_BASE Basisindikator.
PERF_AVERAGE_BULK
Erfordert den PERF_AVERAGE_BASE Basisindikator.
PERF_COUNTER_MULTI_TIMER_INV
Erfordert den PERF_COUNTER_MULTI_BASE Basisindikator.
PERF_LARGE_RAW_FRACTION
Erfordert den PERF_LARGE_RAW_BASE Basisindikator.
PERF_PRECISION_100NS_TIMER
Erfordert den PERF_LARGE_RAW_BASE Basisindikator.
PERF_RAW_FRACTION
Erfordert den PERF_RAW_BASE Basisindikator.
PERF_SAMPLE_FRACTION
Erfordert den PERF_SAMPLE_BASE Basisindikator.
defaultScale Der Skalierungsfaktor, der auf den Zählerwert angewendet werden soll (Faktor * Zählerwert). Der Standardwert ist 0, wenn keine Skalierung angewendet wird. Gültige Werte liegen zwischen 10 und 10 (0,000000000001 bis 100000000000). Wenn dieser Wert 0 ist, ist der Skalierungswert 1; wenn dieser Wert 1 ist, ist der Skalierungswert 10; wenn dieser Wert 1 ist, ist der Skalierungswert .10; Und so weiter.
description xs:string Eine kurze Beschreibung des Zählers. Sie müssen dieses Attribut nicht angeben, wenn der Indikator das NoDisplay-Attribut enthält.
detailLevel Gibt die Zielgruppe für die Leistungsindikatorendetails an. Folgende Werte sind möglich:
Standard
Zeigen Sie Details zum Leistungsindikator an, die ein typischer Benutzer verstehen würde.
Erweiterte
Zeigen Sie Details zum Leistungsindikator an, die nur ein fortgeschrittener Benutzer verstehen würde.
Feld man:CSymbolType Der Name eines Felds in der Struktur, die den Zählerwert enthält. Dieses Attribut ist für Benutzermodusanbieter nicht zulässig.
id man:UInt32Type Eine eindeutige Zahl, die den Zähler innerhalb des Zählersatzes identifiziert.
multiCounterID man:UInt32Type Der Bezeichner eines anderen Zählers innerhalb desselben Zählersatzes, dessen Multiplikatorwert zum Berechnen des Werts dieses Indikators verwendet wird. Für die folgenden Leistungsindikatorentypen ist ein Multiplikatorwert erforderlich. Der Zähler, auf den verwiesen wird, muss vom Typ PERF_COUNTER_RAWCOUNT sein.
  • PERF_COUNTER_MULTI_TIMER
  • PERF_COUNTER_MULTI_TIMER_INV
  • PERF_100NSEC_MULTI_TIMER
  • PERF_100NSEC_MULTI_TIMER_INV
name Der Name des Leistungsindikators. Der Name muss eindeutig und weniger als 1.024 Zeichen sein. Beim Namen wird die Groß- und Kleinschreibung berücksichtigt. Sie müssen dieses Attribut nicht angeben, wenn der Indikator das NoDisplay-Attribut enthält.
perfFreqID man:UInt32Type Der Bezeichner eines anderen Zählers innerhalb desselben Zählersatzes, dessen Häufigkeitswert zum Berechnen des Werts dieses Zählers verwendet wird. Für die folgenden Zählertypen ist eine Häufigkeit erforderlich. Der PERF_COUNTER_LARGE_RAWCOUNT Zählertyp enthält den Zeitstempelwert.
  • PERF_COUNTER_OBJECT_TIME_QUEUELEN_TYPE
  • PERF_ELAPSED_TIME
  • PERF_OBJ_TIME_TIMER
  • PERF_PRECISION_OBJECT_TIMER
perfTimeID man:UInt32Type Der Bezeichner eines anderen Zählers innerhalb desselben Zählersatzes, dessen Zeitstempelwert zum Berechnen des Werts dieses Zählers verwendet wird. Für die folgenden Leistungsindikatorentypen ist ein Zeitstempel erforderlich. Der PERF_COUNTER_LARGE_RAWCOUNT Zählertyp enthält den Zeitstempelwert.
  • PERF_COUNTER_OBJECT_TIME_QUEUELEN_TYPE
  • PERF_ELAPSED_TIME
  • PERF_OBJ_TIME_TIMER
  • PERF_PRECISION_OBJECT_TIMER
struct man:CSymbolType Der Name eines Strukturelements, das diesen Indikatorwert enthält. Dieses Attribut ist für Benutzermodusanbieter nicht zulässig.
Symbol man:CSymbolType Ein symbolischer Name, der den Zähler identifiziert. Das CTRPP-Tool erstellt eine Konstante, die Sie beim Aufrufen von Funktionen verwenden können, die einen Indikatorbezeichner erfordern (z. B. PerfIncrementULongCounterValue). Der Name der Konstante ist der symbolische Name.
type Der Name des Indikatortyps. Mögliche Werte finden Sie im obigen Syntaxblock. Ausführliche Informationen zu den einzelnen Typen finden Sie unter Leistungsindikatortypen im Windows 2003-Bereitstellungshandbuch. Bei dem Namen wird die Groß-/Kleinschreibung beachtet.
uri xs:anyURI Ein eindeutiger einheitlicher Ressourcenbezeichner, mit dem Benutzer Zählerwerte von einem beliebigen Speicherort abrufen können.

Bemerkungen

Um abwärtskompatibel zu sein, sollte jeder Zähler im Leistungsindikatorsatz die gleichen Werte für perfFreqID und perfTimeID angeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2008 [nur Desktop-Apps]