Partager via

PerfIncrementULongLongCounterValue, fonction (perflib.h)

  • Article

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

Syntaxe

ULONG PerfIncrementULongLongCounterValue(
  [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 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 incré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 incrémenter les données brutes du compteur. Pour incré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 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 PerfSetULongLongCounterValue pour définir initialement la valeur du compteur.

Notez que la valeur du compteur déborde lorsque la valeur du compteur s’incrémente au-delà de la taille maximale d’un entier non signé de 8 octets.

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

PerfSetULongLongCounterValue