QueryPerformanceFrequency-Funktion (profileapi.h)

Artikel
03/01/2024

Ruft die Häufigkeit des Leistungsindikators ab. Die Häufigkeit des Leistungsindikators wird beim Systemstart festgelegt und ist für alle Prozessoren konsistent. Daher muss die Häufigkeit nur bei der Anwendungsinitialisierung abgefragt werden, und das Ergebnis kann zwischengespeichert werden.

Syntax

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

Parameter

[out] lpFrequency

Ein Zeiger auf eine Variable, die die aktuelle Leistungsindikatorhäufigkeit in Anzahl pro Sekunde empfängt. Wenn die installierte Hardware keinen hochauflösenden Leistungsindikator unterstützt, kann dieser Parameter null sein (dies tritt nicht auf Systemen auf, auf denen Windows XP oder höher ausgeführt wird).

Rückgabewert

Wenn die installierte Hardware einen hochauflösenden Leistungsindikator unterstützt, ist der Rückgabewert nonzero.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Auf Systemen, auf denen Windows XP oder höher ausgeführt wird, ist die Funktion immer erfolgreich und gibt daher nie null zurück.

Hinweise

Weitere Informationen zu dieser Funktion und ihrer Verwendung finden Sie unter Abrufen hochauflösender Zeitstempel.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	profileapi.h (Einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll