PdhComputeCounterStatistics, fonction (pdh.h)

  • Article

Calcule les statistiques d’un compteur à partir d’un tableau de valeurs brutes.

Syntaxe

PDH_FUNCTION PdhComputeCounterStatistics(
  [in]  PDH_HCOUNTER     hCounter,
  [in]  DWORD            dwFormat,
  [in]  DWORD            dwFirstEntry,
  [in]  DWORD            dwNumEntries,
  [in]  PPDH_RAW_COUNTER lpRawValueArray,
  [out] PPDH_STATISTICS  data
);

Paramètres

[in] hCounter

Handle du compteur pour lequel vous souhaitez calculer les statistiques. La fonction PdhAddCounter retourne ce handle.

[in] dwFormat

Détermine le type de données de la valeur mise en forme. Spécifiez l’une des valeurs suivantes.

Valeur Signification
PDH_FMT_DOUBLE
 Retourne la valeur calculée sous la forme d’un réel à virgule flottante double précision.
PDH_FMT_LARGE
 Retourne la valeur calculée sous la forme d’un entier 64 bits.
PDH_FMT_LONG
 Retourne la valeur calculée sous la forme d’un entier long.
 

Vous pouvez utiliser l’opérateur OR inclusif au niveau du bit (|) pour combiner le type de données avec l’un des facteurs de mise à l’échelle suivants.

Valeur Signification
PDH_FMT_NOSCALE
 N’appliquez pas les facteurs de mise à l’échelle du compteur dans le calcul.
PDH_FMT_NOCAP100
 Les valeurs de compteur supérieures à 100 (par exemple, les valeurs de compteur mesurant la charge du processeur sur les ordinateurs multiprocesseurs) ne sont pas réinitialisées à 100. Le comportement par défaut est que les valeurs de compteur sont limitées à une valeur de 100.
PDH_FMT_1000
 Multipliez la valeur finale par 1 000.

[in] dwFirstEntry

Index de base zéro de la première valeur de compteur brute à utiliser pour commencer les calculs. La valeur d’index doit pointer vers l’entrée la plus ancienne dans la mémoire tampon. La fonction commence à cette entrée et analyse la mémoire tampon, en recapsulant la dernière entrée au début de la mémoire tampon et jusqu’à l’entrée dwFirstEntry-1 , qui est supposée être les données les plus récentes ou les plus récentes.

[in] dwNumEntries

Nombre de valeurs de compteur brutes dans la mémoire tampon lpRawValueArray .

[in] lpRawValueArray

Tableau de structures PDH_RAW_COUNTER qui contiennent des entrées dwNumEntries .

[out] data

Structure PDH_STATISTICS qui reçoit les statistiques de 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 ou un code d’erreur PDH. Voici les valeurs possibles.

Code de retour Description
PDH_INVALID_ARGUMENT
 Un argument n’est pas correct ou est mal mis en forme.
PDH_INVALID_HANDLE
 Le handle de compteur n’est pas valide.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête pdh.h
Bibliothèque Pdh.lib
DLL Pdh.dll

Voir aussi

PDH_RAW_COUNTER

PDH_STATISTICS

PdhCalculateCounterFromRawValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor