PerfQueryCounterInfo-Funktion (perflib.h)
Ruft die Leistungsindikatorenspezifikationen in der angegebenen Abfrage ab.
Syntax
ULONG PerfQueryCounterInfo(
[in] HANDLE hQuery,
[out, optional] PPERF_COUNTER_IDENTIFIER pCounters,
DWORD cbCounters,
[out] LPDWORD pcbCountersActual
);
Parameter
[in] hQuery
Ein Handle für die Abfrage, für die Sie die Leistungsindikatorenspezifikationen abrufen möchten
[out, optional] pCounters
Zeiger auf einen Puffer, der groß genug ist, um die vom cbCounters-Parameter festgelegte Datenmenge in Bytes aufzunehmen. Kann NULL sein, wenn cbCounters 0 ist.
cbCounters
Die Größe des pCounters-Puffers in Bytes.
[out] pcbCountersActual
Die Größe des Puffers, die zum Abrufen der Leistungsindikatorenspezifikationen tatsächlich erforderlich ist. Die Bedeutung hängt vom Wert der Funktion ab.
Gibt.
| Funktionsrückgabewert | Bedeutung von pcbCountersActual |
|---|---|
| ERROR_SUCCESS | Die Anzahl von Byte von Informationen über die Leistungsindikatorenspezifikationen, die die Funktion in dem Puffer gespeichert hat, den pCounters angegeben hat. |
| ERROR_NOT_ENOUGH_MEMORY | The Größe des Puffers, der zum Speichern der Informationen zu den Leistungsindikatorenspezifikationen in Bytes erforderlich ist. Vergrößern Des Puffers auf den erforderlichen größe, und rufen Sie die Funktion erneut auf. |
| Sonstiges | Der Wert ist undefiniert und sollte nicht verwendet werden. |
Rückgabewert
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion speicherte erfolgreich alle Informationen zu den Leistungsindikatorspezifikationen im Puffer, den pCounters angegeben hat . Der Wert, auf den pcbCountersActual verweist, gibt die Menge der tatsächlich im Puffer gespeicherten Informationen in Bytes an. |
|
Der von pCounters angegebene Puffer war nicht groß genug, um alle Informationen zu den Leistungsindikatorspezifikationen zu speichern. Der Wert, auf den pcbCountersActual 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 Leistungsindikatoren werden in den Puffer geschrieben, den pCounters als Sequenz von PERF_COUNTER_IDENTIFIER Blöcken angibt. Die Größe in Bytes von
die Sequenz der Blöcke wird in pcbCountersActual geschrieben. Jeder PERF_COUNTER_IDENTIFIER-Block besteht aus
einer PERF_COUNTER_IDENTIFIER-Struktur , optional gefolgt von einem NULL-beendeten UTF-16LE
instance Namen, gefolgt von Auffüllung, damit die Größe des
PERF_COUNTER_IDENTIFIER Block ist ein Vielfaches von 8 Bytes. Die Größe jedes Blocks, einschließlich der PERF_COUNTER_IDENTIFIER-Struktur, instance Namen und des Abstands, wird durch das Size-Element der PERF_COUNTER_IDENTIFIER-Struktur bestimmt, bei dem es sich um ein Vielfaches von 8 Bytes handelt.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |