type complexe counterSet

Définit une liste de compteurs qui sont liés logiquement.

<xs:complexType name="counterSet">
    <xs:sequence>
        <xs:element name="structs"
            type="man:structs"
            minOccurs="0"
            maxOccurs="1"
         />
        <xs:element name="counter"
            type="man:counter"
            minOccurs="1"
            maxOccurs="unbounded"
         />
    </xs:sequence>
    <xs:attribute name="symbol"
        type="man:CSymbolType"
        use="required"
     />
    <xs:attribute name="guid"
        type="man:GUIDType"
        use="required"
     />
    <xs:attribute name="uri"
        type="xs:anyURI"
        use="required"
     />
    <xs:attribute name="name"
        use="required"
    >
        <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="required"
     />
    <xs:attribute name="instances"
        use="optional"
        default="single"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="single"
                 />
                <xs:enumeration
                    value="multiple"
                 />
                <xs:enumeration
                    value="globalAggregate"
                 />
                <xs:enumeration
                    value="multipleAggregate"
                 />
                <xs:enumeration
                    value="globalAggregateHistory"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
</xs:complexType>

Éléments enfants

Élément	Type	Description
Counter	man:counter	Définit un compteur fourni par le fournisseur.
Structs	man:structs	Liste d’éléments struct qui contiennent des valeurs pour les compteurs définis dans ce jeu de compteurs.

Attributs

Nom	Type	Description
description	xs:string	Brève description du jeu de compteurs.
guid	man:GUIDType	GUID qui identifie de manière unique le jeu de compteurs. L’inscription du jeu de compteurs échoue si le GUID est déjà inscrit. Pour mettre à jour un jeu de compteurs inscrit, vous devez d’abord désinstaller le jeu de compteurs, puis l’inscrire à nouveau.
instances		Détermine si le jeu de compteurs peut contenir plusieurs instances. Voici la liste des valeurs possibles : Seul Définit un jeu de compteurs dans lequel un seul instance des compteurs peut exister. Spécifiez cette valeur si les compteurs fournissent des mesures à l’échelle du système, telles que la mémoire physique. Il s’agit de la valeur par défaut. Plusieurs Définit un jeu de compteurs où plusieurs instances des compteurs dans le jeu de compteurs peuvent exister. Spécifiez cette valeur si les compteurs fournissent des mesures par instance, telles que le temps processeur par processus. globalAggregate Définit un jeu de compteurs instance unique où les compteurs du jeu de compteurs doivent être agrégés à partir de différentes sources actives. Par exemple, vous pouvez créer un jeu de compteurs qui contient un compteur qui compte le nombre de lectures de disque pour un disque dur. Si l’ordinateur dispose de trois disques durs et qu’un consommateur demande le nombre de lectures de disque, PERFLIB obtient le nombre de lectures de chaque disque et additionne leurs valeurs individuelles. multipleAggregate Définit un jeu de compteurs instance multiples où les compteurs du jeu de compteurs doivent être agrégés sur toutes les instances de ce compteur. Par exemple, vous pouvez créer un jeu de compteurs pour une application multithread qui contient un compteur qui mesure les performances des threads (chaque thread fait référence à un instance du jeu de compteurs). Lorsqu’un consommateur interroge le compteur de temps d’exécution de thread total, PERFLIB additionne le temps d’exécution total du thread de chaque instance. globalAggregateHistory Définit un jeu de compteurs instance dont les valeurs de compteur sont mises en cache pendant la durée de vie du consommateur. Notez que tous les compteurs du jeu de compteurs sont mis en cache. Pour mettre en cache uniquement des compteurs spécifiques, décorez ces compteurs avec l’attribut d’historique. À l’aide de l’exemple de lecture de disque de globalAggregate, toutes les valeurs de compteur dans le jeu de compteurs sont mises en cache. Si un disque n’est plus disponible, la dernière valeur mise en cache pour le nombre total d’octets lus par ce disque est toujours disponible pour l’application consommateur.
name		Nom d’affichage du jeu de compteurs. Doit contenir moins de 1 024 caractères. Cette valeur respecte la casse.
symbole	man:CSymbolType	Nom symbolique qui identifie le jeu de compteurs. L’outil CTRPP crée une variable GUID que vous pouvez utiliser lors de l’appel de fonctions qui nécessitent le GUID de jeu de compteurs (par exemple, PerfCreateInstance). Le nom de la variable est de la forme , symbolnameGUID. Si vous incluez l’argument -préfixe lors de l’appel de CTRPP, la chaîne de préfixe est ajoutée au début du nom symbolique.
URI	xs:anyURI	Identificateur de ressource uniforme unique qui permet aux utilisateurs d’accéder aux compteurs dans le jeu de compteurs à partir de n’importe quel emplacement.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]