Type complexe du fournisseur
Définit un fournisseur et les compteurs qu’il fournit.
<xs:complexType name="provider">
<xs:choice
minOccurs="0"
maxOccurs="unbounded"
>
<xs:element name="counterSet"
type="man:counterSet"
>
<xs:key name="uniqueCounterID">
<xs:selector
xpath="./man:counter"
/>
<xs:field
xpath="@id"
/>
</xs:key>
<xs:unique name="uniqueCounterName">
<xs:selector
xpath="./man:counter"
/>
<xs:field
xpath="@name"
/>
</xs:unique>
<xs:keyref name="existBaseID">
<xs:selector
xpath="./man:counter"
/>
<xs:field
xpath="@baseID"
/>
</xs:keyref>
<xs:keyref name="existPerfTimeID">
<xs:selector
xpath="./man:counter"
/>
<xs:field
xpath="@perfTimeID"
/>
</xs:keyref>
<xs:keyref name="existPerfFreqID">
<xs:selector
xpath="./man:counter"
/>
<xs:field
xpath="@perfFreqID"
/>
</xs:keyref>
<xs:keyref name="existMultiCounterID">
<xs:selector
xpath="./man:counter"
/>
<xs:field
xpath="@multiCounterID"
/>
</xs:keyref>
<xs:key name="uniqueStructNames">
<xs:selector
xpath="./man:structs/man:struct"
/>
<xs:field
xpath="@name"
/>
</xs:key>
<xs:keyref name="existCounterName">
<xs:selector
xpath="./man:counter"
/>
<xs:field
xpath="@struct"
/>
</xs:keyref>
</xs:element>
</xs:choice>
<xs:attribute name="symbol"
type="man:CSymbolType"
use="optional"
/>
<xs:attribute name="callback"
use="optional"
default="default"
>
<xs:simpleType>
<xs:restriction
base="xs:string"
>
<xs:enumeration
value="custom"
/>
<xs:enumeration
value="default"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="providerGuid"
type="man:GUIDType"
use="required"
/>
<xs:attribute name="applicationIdentity"
type="xs:string"
use="required"
/>
<xs:attribute name="providerType"
use="optional"
default="userMode"
>
<xs:simpleType>
<xs:restriction
base="xs:string"
>
<xs:enumeration
value="userMode"
/>
<xs:enumeration
value="kernelMode"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="providerName"
type="xs:string"
use="optional"
default="Counters"
/>
<xs:attribute name="resourceBase"
type="man:UInt32Type"
use="optional"
/>
</xs:complexType>
Éléments enfants
| Élément | Type | Description |
|---|---|---|
| counterSet | Man : counterSet | Identifie l’ensemble de compteurs qui contient un ou plusieurs compteurs logiquement liés. |
Attributs
| Nom | Type | Description | |||||
|---|---|---|---|---|---|---|---|
| applicationIdentity | xs:string | Nom du fichier binaire qui contient les chaînes de ressources localisées, soit un fichier .exe, soit .dll (n’incluez pas le chemin d’accès au fichier binaire). L’utilitaire Lodctr.exe utilise le chemin d’accès à partir du paramètre facultatif [path] pour rechercher le fichier binaire. Par exemple, lodctr [/m :Manifest [chemin]]. Si vous n’incluez pas le paramètre [path], Lodctr.exe recherche le dossier qui contient le manifeste. |
|||||
| rappel | Cet attribut indique que vous souhaitez recevoir une notification lorsqu’un consommateur effectue certaines actions. Si vous incluez cet attribut, l’outil CTRPP utilise la signature de fonction CounterInitialize de remplacement, que vous utilisez pour passer le nom de votre fonction qui implémente la fonction de rappel ControlCallback . En guise d’alternative à la spécification de cet attribut, vous pouvez utiliser l’argument -NotificationCallbackCTRPP . Windows Vista : La seule valeur valide pour cet attribut est " Custom " . L’utilitaire CTRPP génère le modèle pour une fonction de rappel ControlCallback . Le modèle est inclus dans le fichier. c que CTRPP a généré. |
||||||
| providerGuid | homme : GUIDType | GUID de chaîne qui identifie de façon unique le fournisseur dans le manifeste. Le GUID doit être unique dans le manifeste. Vous devez fournir un nouveau GUID uniquement lorsque la version de l’application change (si vous prenez en charge les installations côte à côte). |
|||||
| providerName | xs:string | Nom utilisé pour créer le nom de la classe de Win32_PerfRawData WMI. Si vous ne spécifiez pas de nom, " " les compteurs sont utilisés comme nom de la classe. |
|||||
| providerType | Indique si le fournisseur est un fournisseur en mode utilisateur, un fournisseur en mode noyau ou un fournisseur de pilotes. Les valeurs possibles sont les suivantes.
|
||||||
| resourceBase | homme : UInt32Type | Définit la valeur initiale de l’index de ressource utilisée par CTRPP pour générer les identificateurs de ressource. |
|||||
| symbole | homme : CSymbolType | Nom symbolique qui identifie le fournisseur. L’outil CTRPP crée une variable de handle que vous pouvez utiliser lors de l’appel de fonctions qui requièrent un handle pour le fournisseur (par exemple, PerfSetULongCounterValue). Le nom symbolique est le nom de la variable. Si vous incluez l’argument -prefix lors de l’appel de CTRPP, la chaîne de préfixe est ajoutée au début du nom symbolique. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau Vista uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2008 [ applications de bureau uniquement] |