structure PERF_DATA_BLOCK (winperf.h)

Décrit le bloc de données de performances que vous avez interrogé, par exemple, le nombre d’objets de performances retournés par le fournisseur et les valeurs basées sur le temps que vous utilisez pour calculer les valeurs de performances.

Syntaxe

typedef struct _PERF_DATA_BLOCK {
  WCHAR         Signature[4];
  DWORD         LittleEndian;
  DWORD         Version;
  DWORD         Revision;
  DWORD         TotalByteLength;
  DWORD         HeaderLength;
  DWORD         NumObjectTypes;
  LONG          DefaultObject;
  SYSTEMTIME    SystemTime;
  LARGE_INTEGER PerfTime;
  LARGE_INTEGER PerfFreq;
  LARGE_INTEGER PerfTime100nSec;
  DWORD         SystemNameLength;
  DWORD         SystemNameOffset;
} PERF_DATA_BLOCK, *PPERF_DATA_BLOCK;

Membres

Signature[4]

Tableau de quatre caractères larges qui contient « PERF ».

LittleEndian

Indique si les valeurs de compteur sont au format big endian ou petit format endian. Le cas échéant, les valeurs de compteur sont dans un format peu endian. Si zéro, les valeurs de compteur sont au format big endian. Cette valeur peut être égale à zéro (format big endian) si vous récupérez des données de performances à partir d’un ordinateur étranger, tel qu’un ordinateur UNIX.

Version

Version des structures de performances.

Revision

Révision des structures de performances.

TotalByteLength

Taille totale du bloc de données de performances, en octets.

HeaderLength

Taille de cette structure, en octets. Vous utilisez la longueur de l’en-tête pour rechercher la première structure PERF_OBJECT_TYPE dans le bloc de données de performances.

NumObjectTypes

Nombre d’objets de performances dans le bloc de données de performances.

DefaultObject

Réservé.

SystemTime

Heure à laquelle le système a été surveillé. Ce membre est au format UTC (Temps universel coordonné).

PerfTime

Valeur du compteur de performances, en nombres, pour le système surveillé. Pour plus d’informations, consultez QueryPerformanceCounter.

PerfFreq

Fréquence des compteurs de performances, en nombre par seconde, pour le système surveillé. Pour plus d’informations, consultez QueryPerformanceFrequency.

PerfTime100nSec

Valeur du compteur de performances, en unités de 100 nanosecondes, pour le système surveillé. Pour plus d’informations, consultez GetSystemTimeAsFileTime.

SystemNameLength

Taille du nom de l’ordinateur situé dans SystemNameOffset, en octets.

SystemNameOffset

Décalage entre le début de cette structure et le nom Unicode de l’ordinateur surveillé.

Remarques

Le bloc de données de performances est retourné lorsqu’un consommateur appelle RegQueryValueEx pour récupérer un ou plusieurs objets de performance. Cette structure est la première structure du bloc retourné. La structure suivante du bloc est la structure PERF_OBJECT_TYPE , qui définit un objet de performance. Pour plus d’informations sur la disposition du bloc de données de performances, consultez Format des données de performance.

Les consommateurs utilisent PerfTime, PerfFreq et PerfTime100nSec lors du calcul des valeurs de compteur, sauf si le type de compteur contient l’indicateur PERF_OBJECT_TIMER , auquel cas le consommateur utilise les membres PerfTime et PerfFreq de PERF_OBJECT_TYPE.

Configuration requise

Voir aussi

PERF_OBJECT_TYPE

Format des données de performances