PerfQueryCounterData-Funktion (perflib.h)

Artikel
08/25/2023

Ruft die Werte der Leistungsindikatoren ab, die den Leistungsindikatorspezifikationen in der angegebenen Abfrage entsprechen.

Syntax

ULONG PerfQueryCounterData(
  [in]            HANDLE            hQuery,
  [out, optional] PPERF_DATA_HEADER pCounterBlock,
                  DWORD             cbCounterBlock,
  [out]           LPDWORD           pcbCounterBlockActual
);

Parameter

[in] hQuery

Ein Handle für eine Abfrage für die Leistungsindikatorenspezifikationen der Leistungsindikatoren, für die Sie die Werte abrufen möchten.

[out, optional] pCounterBlock

Ein Zeiger auf einen Puffer, der über genügend Speicherplatz verfügt, um die vom cbCounterBlock-Parameter festgelegte Datenmenge in Bytes zu empfangen. Kann NULL sein, wenn

cbCounterBlock ist 0.

cbCounterBlock

Die Größe des Puffers, den der pCounterBlock-Parameter angibt, in Bytes.

[out] pcbCounterBlockActual

Die Größe des Puffers, die zum Abrufen der Leistungsindikatorwerte tatsächlich erforderlich ist. Die Bedeutung hängt vom Wert der Funktion ab.

Gibt.

Funktionsrückgabewert	Bedeutung von pcbCounterBlockActual
ERROR_SUCCESS	Die Anzahl von Bytes von Leistungsindikatorwerten, die die Funktion in dem Puffer gespeichert hat, den pCounterBlock angegeben hat.
ERROR_NOT_ENOUGH_MEMORY	The Größe des Puffers, der zum Speichern der Leistungsindikatorwerte in Bytes erforderlich ist. Vergrößern Des Puffers auf den erforderlichen größe, und rufen Sie die Funktion erneut auf.
Andere	Der Wert ist undefiniert und sollte nicht verwendet werden.

Funktionsrückgabewert

Bedeutung von pcbCounterBlockActual

ERROR_SUCCESS

Die Anzahl von

Bytes von Leistungsindikatorwerten, die die Funktion in dem Puffer gespeichert hat, den pCounterBlock angegeben hat.

ERROR_NOT_ENOUGH_MEMORY

The

Größe des Puffers, der zum Speichern der Leistungsindikatorwerte in Bytes erforderlich ist. Vergrößern Des Puffers auf den erforderlichen

größe, und rufen Sie die Funktion erneut auf.

Andere

Der Wert ist undefiniert und sollte nicht verwendet werden.

Rückgabewert

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die Funktion speicherte erfolgreich alle angeforderten Leistungsindikatorwerte im Puffer, den pCounterBlock angegeben hat. Der Wert, auf den pcbCounterBlockActual verweist, gibt die Menge der tatsächlich im Puffer gespeicherten Informationen in Bytes an.
ERROR_NOT_ENOUGH_MEMORY	Der von pCounterBlock angegebene Puffer war nicht groß genug, um alle angeforderten Leistungsindikatorwerte zu speichern. Der Wert, auf den pcbCounterBlockActual verweist, gibt die Größe des Puffers an, der zum Speichern aller Informationen erforderlich ist. Vergrößern Des Puffers auf den erforderlichen größe, und rufen Sie die Funktion erneut auf.

Bei anderen Fehlertypen ist der Rückgabewert ein Systemfehlercode.

Hinweise

Die Informationen zu den Leistungsindikatorwerten werden in den Puffer geschrieben, den pCounterBlock als PERF_DATA_HEADER-Block angibt, der aus PERF_DATA_HEADER Struktur gefolgt von einer Sequenz von PERF_COUNTER_HEADER Blöcken besteht.

Anforderungen


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

Weitere Informationen

PERF_COUNTER_HEADER

PERF_DATA_HEADER