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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| En-tête | winperf.h (inclure Windows.h) |