PerfQueryCounterInfo-Funktion (perflib.h)

Artikel
03/04/2024

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.

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

Weitere Informationen

PERF_COUNTER_IDENTIFIER