tipo complesso del contatore

  • Articolo

Definisce un contatore.

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

Elementi figlio

Elemento Tipo Descrizione
counterAttributes man:counterAttributes Elenca gli attributi univoci che specificano la modalità di visualizzazione dei dati del contatore in un'applicazione consumer.

Attributi

Nome Tipo Descrizione
aggregate Funzione di aggregazione da applicare se l'attributo istanze di counterSet è globalAggregate, multipleAggregate o globalAggregateHistory. Di seguito sono riportate le possibili funzioni di aggregazione che è possibile applicare:
Massimo
Viene restituito il valore massimo del contatore.
Minimo
Viene restituito il valore minimo del contatore.
Media
Viene restituito il valore medio del contatore.
Somma
Viene restituita la somma dei valori del contatore.
Indefinito
Non aggregare questo contatore.
baseID man:UInt32Type Identificatore di un altro contatore all'interno dello stesso set di contatori, il cui valore viene usato per calcolare il valore di questo contatore. I tipi di contatore seguenti richiedono un contatore di base:
PERF_AVERAGE_TIMER
Richiede il contatore di base PERF_AVERAGE_BASE.
PERF_AVERAGE_BULK
Richiede il contatore di base PERF_AVERAGE_BASE.
PERF_COUNTER_MULTI_TIMER_INV
Richiede il contatore di base PERF_COUNTER_MULTI_BASE.
PERF_LARGE_RAW_FRACTION
Richiede il contatore di base PERF_LARGE_RAW_BASE.
PERF_PRECISION_100NS_TIMER
Richiede il contatore di base PERF_LARGE_RAW_BASE.
PERF_RAW_FRACTION
Richiede il contatore di base PERF_RAW_BASE.
PERF_SAMPLE_FRACTION
Richiede il contatore di base PERF_SAMPLE_BASE.
defaultScale Fattore di scala da applicare al valore del contatore (fattore * valore contatore). Il valore predefinito è zero se non viene applicata alcuna scala. I valori validi vanno da 10 a 10 (0,000000000001 a 10000000000). Se questo valore è zero, il valore di scala è 1; se questo valore è 1, il valore di scala è 10; se questo valore è 1, il valore di scala è .10; E così via.
description xs:string Breve descrizione del contatore. Non è necessario specificare questo attributo se il contatore include l'attributo noDisplay .
detailLevel Specifica il pubblico di destinazione per i dettagli del contatore. Di seguito sono indicati i valori possibili:
Standard
Visualizzare i dettagli sul contatore che un utente tipico avrebbe compreso.
Avanzate
Visualizzare i dettagli sul contatore che solo un utente avanzato avrebbe compreso.
campo man:CSymbolType Nome di un campo all'interno dello struct contenente il valore del contatore. Questo attributo non è consentito per i provider in modalità utente.
id man:UInt32Type Numero univoco che identifica il contatore all'interno del set di contatori.
multiCounterID man:UInt32Type Identificatore di un altro contatore all'interno dello stesso set di contatori, il cui valore moltiplicatore viene usato per calcolare il valore del contatore. I tipi di contatore seguenti richiedono un valore moltiplicatore. Il contatore a cui si fa riferimento deve essere di tipo PERF_COUNTER_RAWCOUNT.
  • PERF_COUNTER_MULTI_TIMER
  • PERF_COUNTER_MULTI_TIMER_INV
  • PERF_100NSEC_MULTI_TIMER
  • PERF_100NSEC_MULTI_TIMER_INV
name Nome del contatore. Il nome deve essere univoco e minore di 1.024 caratteri. Per il nome è prevista la distinzione tra maiuscole e minuscole. Non è necessario specificare questo attributo se il contatore include l'attributo noDisplay .
perfFreqID man:UInt32Type Identificatore di un altro contatore all'interno dello stesso set di contatori, il cui valore di frequenza viene usato per calcolare il valore del contatore. I tipi di contatore seguenti richiedono una frequenza. Il tipo di contatore PERF_COUNTER_LARGE_RAWCOUNT contiene il valore del timestamp.
  • PERF_COUNTER_OBJECT_TIME_QUEUELEN_TYPE
  • PERF_ELAPSED_TIME
  • PERF_OBJ_TIME_TIMER
  • PERF_PRECISION_OBJECT_TIMER
perfTimeID man:UInt32Type Identificatore di un altro contatore all'interno dello stesso set di contatori, il cui valore timestamp viene usato per calcolare il valore del contatore. I tipi di contatore seguenti richiedono un timestamp. Il tipo di contatore PERF_COUNTER_LARGE_RAWCOUNT contiene il valore del timestamp.
  • PERF_COUNTER_OBJECT_TIME_QUEUELEN_TYPE
  • PERF_ELAPSED_TIME
  • PERF_OBJ_TIME_TIMER
  • PERF_PRECISION_OBJECT_TIMER
struct man:CSymbolType Nome di un elemento struct che contiene questo valore del contatore. Questo attributo non è consentito per i provider in modalità utente.
simbolo man:CSymbolType Nome simbolico che identifica il contatore. Lo strumento CTRPP crea una costante che è possibile usare quando si chiamano funzioni che richiedono un identificatore di contatore, ad esempio PerfIncrementULongCounterValue. Il nome della costante è il nome simbolico.
tipo Nome del tipo di contatore. Per i valori possibili, vedere il blocco di sintassi precedente. Per informazioni dettagliate su ogni tipo, vedere Tipi di contatori nella Guida alla distribuzione di Windows 2003. Il nome fa distinzione tra maiuscole e minuscole.
Uri xs:anyURI Identificatore univoco delle risorse uniformi che consente agli utenti di recuperare i valori dei contatori da qualsiasi posizione.

Commenti

Per garantire la compatibilità con le versioni precedenti, ogni contatore nel set di contatori deve specificare gli stessi valori perfFreqID e perfTimeID .

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista [solo app desktop]
Server minimo supportato
 Windows Server 2008 [solo app desktop]