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 |
|---|---|
|
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. |
|
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 |