Fonction PerfDecrementULongLongCounterValue (perflib.h)

Article
03/06/2024

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

Syntaxe

ULONG PerfDecrementULongLongCounterValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] ULONGLONG                 Value
);

Paramètres

[in] Provider

Handle du fournisseur. Utilisez la variable handle que l’outil CTRPP a générée pour vous. Pour connaître 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 obtenir le nom de la constante, consultez l’attribut symbol de l’élément counter .

Windows Vista : La constante ID du 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 les données de compteur brutes. Pour décrémenter les données brutes du compteur vous-même, utilisez le membre Offset de la structure PERF_COUNTER_INFO pour accéder aux données brutes du compteur pour un compteur spécifique. Le bloc de structure PERF_COUNTERSET_INSTANCE contient une ou plusieurs structures d’informations de compteur.

Utilisez la fonction PerfSetULongLongCounterValue 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

PerfDecrementULongCounterValue

PerfIncrementULongLongCounterValue

PerfSetULongLongCounterValue

Partager via