PerfDecrementULongCounterValue, fonction (perflib.h)

Article
03/01/2024

Décrémente la valeur d’un compteur dont la valeur est un entier non signé de 4 octets. Les fournisseurs utilisent cette fonction.

Syntaxe

ULONG PerfDecrementULongCounterValue(
  [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

Valeur par laquelle décrémenter le compteur.

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écrémenter des données de compteur brutes. Pour décrémenter 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 de compteur brutes d’un compteur spécifique. Le bloc de structure PERF_COUNTERSET_INSTANCE contient une ou plusieurs structures d’informations de compteur.

Utilisez la fonction PerfSetULongCounterValue pour définir initialement la valeur du compteur.

Notez que la valeur du compteur est inférieure lorsque la valeur du compteur décrémente au-delà de zéro.

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

PerfDecrementULongLongCounterValue

PerfIncrementULongCounterValue

PerfSetULongCounterValue

Partager via