PERF_COUNTER_HEADER-Struktur (perflib.h)

Artikel
08/25/2023

Enthält Informationen zum PERF_COUNTER_HEADER Block, der die -Struktur enthält. Ein PERF_COUNTER_HEADER-Block stellt Fehlerinformationen und Daten für Leistungsindikatorabfragen bereit und besteht aus einer PERF_COUNTER_HEADER-Struktur gefolgt von zusätzlichen Leistungsindikatordaten.

Syntax

typedef struct _PERF_COUNTER_HEADER {
  ULONG               dwStatus;
  PerfCounterDataType dwType;
  ULONG               dwSize;
  ULONG               Reserved;
} PERF_COUNTER_HEADER, *PPERF_COUNTER_HEADER;

Members

dwStatus

Ein Fehlercode, der angibt, ob der Vorgang zum Abfragen der Leistung erfolgreich war oder fehlgeschlagen ist.

dwType

Der Typ der Leistungsindikatorinformationen, die der PERF_COUNTER_HEADER-Block bereitstellt.

Wert	Bedeutung
PERF_ERROR_RETURN	Ein Fehler, der das Ergebnis einer Leistungsindikatorabfrage war. Die Leistungsbibliothek kann keine gültigen Leistungsindikatordaten vom Anbieter zurückholen. Der PERF_COUNTER_HEADER-Struktur folgen keine zusätzlichen Daten. Der dwStatus-Member der -Struktur enthält den Fehlercode.
PERF_SINGLE_COUNTER	Das Ergebnis einer Einzelzählerabfrage mit instance, z. B. "\Processor(_Total)\% Processor Time". Die zusätzlichen Daten bestehen aus einem PERF_COUNTER_DATA-Block .
PERF_MULTIPLE_COUNTERS	Das Ergebnis einer Abfrage mit mehreren Zählern mit einem einzelnen instance, z. B. "\Processor(_Total)\*". Die zusätzlichen Daten bestehen aus einem PERF_MULTI_COUNTERS-Block gefolgt von PERF_COUNTER_DATA Blöcken.
PERF_MULTIPLE_INSTANCES	Das Ergebnis einer Abfrage mit einem einzelnen Zähler mit mehreren instance, z. B. "\Processor(*)\% Processor Time". Die zusätzlichen Daten bestehen aus einem PERF_MULTI_INSTANCES-Block .
PERF_COUNTERSET	Das Ergebnis einer Abfrage mit mehreren Zählern, multi-instance, z. B. "\Processor()\". Die zusätzlichen Daten bestehen aus einem PERF_MULTI_COUNTERS-Block gefolgt von einem PERF_MULTI_INSTANCES-Block .

dwSize

Die Gesamtgröße des PERF_COUNTER_HEADER Blocks, die der Summe der Größe der PERF_COUNTER_HEADER-Struktur und der Größe der zusätzlichen Daten entspricht.

Reserved

Reserviert.

Hinweise

Die PerfQueryCounterData-Funktion gibt einen PERF_DATA_HEADER-Block zurück, der eine Sequenz von PERF_COUNTER_HEADER Blöcken enthält.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Kopfzeile	perflib.h

Weitere Informationen

Freigeben über