Partager via


Fonction PerfQueryCounterData (perflib.h)

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 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