Freigeben über


PerfQueryCounterData-Funktion (perflib.h)

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.

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