Fonction PerfQueryCounterInfo (perflib.h)

Article
03/04/2024

Obtient les spécifications de compteur dans la requête spécifiée.

Syntaxe

ULONG PerfQueryCounterInfo(
  [in]            HANDLE                   hQuery,
  [out, optional] PPERF_COUNTER_IDENTIFIER pCounters,
                  DWORD                    cbCounters,
  [out]           LPDWORD                  pcbCountersActual
);

Paramètres

[in] hQuery

Handle de la requête pour laquelle vous souhaitez obtenir les spécifications de compteur

[out, optional] pCounters

Pointeur vers une mémoire tampon suffisamment grande pour contenir la quantité de données spécifiée par le paramètre cbCounters , en octets. Peut être NULL si cbCounters est 0.

cbCounters

Taille de la mémoire tampon pCounters , en octets.

[out] pcbCountersActual

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

Retourne.

Valeur de retour de fonction	Signification de pcbCountersActual
ERROR_SUCCESS	Nombre de octets d’informations sur les spécifications de compteur que la fonction a stockées dans la mémoire tampon spécifiée par pCounters .
ERROR_NOT_ENOUGH_MEMORY	The taille de la mémoire tampon requise pour stocker les informations sur les spécifications du compteur, 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 pcbCountersActual

ERROR_SUCCESS

Nombre de

octets d’informations sur les spécifications de compteur que la fonction a stockées dans la mémoire tampon spécifiée par pCounters .

ERROR_NOT_ENOUGH_MEMORY

The

taille de la mémoire tampon requise pour stocker les informations sur les spécifications du compteur, 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 informations sur les spécifications du compteur dans la mémoire tampon spécifiée par pCounters . Valeur que pointe pcbCountersActual 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 pCounters n’était pas assez grande pour stocker toutes les informations sur les spécifications du compteur. La valeur vers laquelle pointe pcbCountersActual 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.

Remarques

Les informations sur les spécifications de compteur sont écrites dans la mémoire tampon spécifiée par pCounters sous la forme d’une séquence de blocs PERF_COUNTER_IDENTIFIER . Taille en octets de

la séquence de blocs est écrite dans pcbCountersActual. Chaque bloc PERF_COUNTER_IDENTIFIER se compose de

d’une structure PERF_COUNTER_IDENTIFIER , éventuellement suivie d’un UTF-16LE avec fin null

instance nom, suivi d’un remplissage de sorte que la taille du

PERF_COUNTER_IDENTIFIER bloc est un multiple de 8 octets. La taille de chaque bloc, y compris la structure PERF_COUNTER_IDENTIFIER, le nom instance et le remplissage, est déterminée par le membre Size de la structure PERF_COUNTER_IDENTIFIER, qui sera un multiple de 8 octets.

Configuration requise

Condition requise	Valeur
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_IDENTIFIER

Partager via