Partager via


Fonction PerfQueryCounterInfo (perflib.h)

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