Fonction PerfQueryCounterData (perflib.h)

Article
08/25/2023

Obtient les valeurs des compteurs de performances qui correspondent aux spécifications du compteur dans la requête spécifiée.

Syntaxe

ULONG PerfQueryCounterData(
  [in]            HANDLE            hQuery,
  [out, optional] PPERF_DATA_HEADER pCounterBlock,
                  DWORD             cbCounterBlock,
  [out]           LPDWORD           pcbCounterBlockActual
);

Paramètres

[in] hQuery

Handle d’une requête pour les spécifications de compteur des compteurs de performances pour lesquels vous souhaitez obtenir les valeurs.

[out, optional] pCounterBlock

Pointeur vers une mémoire tampon qui a suffisamment d’espace pour recevoir la quantité de données spécifiée par le paramètre cbCounterBlock , en octets. Peut avoir la valeur NULL si

cbCounterBlock est 0.

cbCounterBlock

Taille de la mémoire tampon spécifiée par le paramètre pCounterBlock , en octets.

[out] pcbCounterBlockActual

Taille de la mémoire tampon réellement requise pour obtenir les valeurs du compteur de performances. La signification dépend de la valeur que la fonction

Retourne.

Valeur de retour de fonction	Signification de pcbCounterBlockActual
ERROR_SUCCESS	Nombre de octets de valeurs de compteur de performances que la fonction stockée dans la mémoire tampon spécifiée par pCounterBlock .
ERROR_NOT_ENOUGH_MEMORY	The taille de la mémoire tampon requise pour stocker les valeurs du compteur de performances, en octets. Agrandir la mémoire tampon pour qu’elle soit requise dimensionner et appeler à nouveau la fonction.
Autres	La valeur n’est pas définie et ne doit pas être utilisée.

Valeur de retour de fonction

Signification de pcbCounterBlockActual

ERROR_SUCCESS

Nombre de

octets de valeurs de compteur de performances que la fonction stockée dans la mémoire tampon spécifiée par pCounterBlock .

ERROR_NOT_ENOUGH_MEMORY

The

taille de la mémoire tampon requise pour stocker les valeurs du compteur de performances, en octets. Agrandir la mémoire tampon pour qu’elle soit requise

dimensionner et appeler à nouveau la fonction.

Autres

La valeur n’est pas définie et ne doit pas être utilisée.

Valeur retournée

Code de retour	Description
ERROR_SUCCESS	La fonction a correctement stocké toutes les valeurs du compteur de performances demandées dans la mémoire tampon spécifiée par pCounterBlock . Valeur que pointe pcbCounterBlockActual pour indiquer la quantité d’informations réellement stockées dans la mémoire tampon, en octets.
ERROR_NOT_ENOUGH_MEMORY	La mémoire tampon spécifiée par pCounterBlock n’était pas assez grande pour stocker toutes les valeurs de compteur de performances demandées. La valeur vers laquelle pointe pcbCounterBlockActual indique la taille de la mémoire tampon requise pour stocker toutes les informations. Agrandir la mémoire tampon pour qu’elle soit requise dimensionner et appeler à nouveau la fonction.

Pour d’autres types d’échecs, la valeur de retour est un code d’erreur système.

Notes

Les informations sur les valeurs du compteur de performances sont écrites dans la mémoire tampon que pCounterBlock spécifie comme bloc PERF_DATA_HEADER , qui se compose PERF_DATA_HEADER structure suivie d’une séquence de blocs PERF_COUNTER_HEADER .

Spécifications


Client minimal pris en charge	Windows 10, version 1607 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	perflib.h
Bibliothèque	AdvAPI32.lib
DLL	AdvAPI32.dll

Voir aussi

PERF_COUNTER_HEADER

PERF_DATA_HEADER

Partager via