Fonction PerfSetULongCounterValue (perflib.h)
Mises à jour la valeur d’un compteur dont la valeur est un entier non signé de 4 octets. Les fournisseurs utilisent cette fonction.
Syntaxe
ULONG PerfSetULongCounterValue(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE Instance,
[in] ULONG CounterId,
[in] ULONG Value
);
Paramètres
[in] Provider
Handle du fournisseur. Utilisez la variable handle que l’outil CTRPP a générée pour vous. Pour le nom de la variable, consultez l’attribut symbol de l’élément provider .
Windows Vista : La fonction PerfStartProvider retourne le handle.
[in] Instance
Structure PERF_COUNTERSET_INSTANCE qui contient le jeu de compteurs instance. La fonction PerfCreateInstance retourne ce pointeur.
[in] CounterId
Identificateur qui identifie de manière unique le compteur à mettre à jour dans le bloc instance. L’identificateur est défini dans l’attribut id de l’élément counter et doit correspondre au membre CounterId de l’une des structures PERF_COUNTER_INFO dans le bloc instance. Utilisez la constante d’ID de compteur que l’outil CTRPP a générée pour vous. Pour le nom de la constante, consultez l’attribut symbol de l’élément counter .
Windows Vista : La constante d’ID de compteur n’est pas disponible.
[in] Value
Nouvelle valeur de compteur de 4 octets.
Valeur retournée
Si la fonction réussit, elle retourne ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur système.
Remarques
Il s’agit d’une fonction pratique pour définir des données de compteur brutes. Pour mettre à jour vous-même les données brutes du compteur, utilisez le membre Offset de la structure PERF_COUNTER_INFO pour accéder aux données brutes d’un compteur spécifique. Le bloc de structure PERF_COUNTERSET_INSTANCE contient une ou plusieurs structures d’informations de compteur.
Vous pouvez utiliser les fonctions PerfIncrementULongCounterValue et PerfDecrementULongCounterValue pour incrémenter ou décrémenter la valeur du compteur, respectivement.
Configuration requise
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] |
Plateforme cible | Windows |
En-tête | perflib.h |
Bibliothèque | Advapi32.lib |
DLL | Advapi32.dll |
Voir aussi
PerfDecrementULongCounterValue
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour