QueryPerformanceCounter-Funktion (profileapi.h)

Artikel
03/01/2024

Ruft den aktuellen Wert des Leistungsindikators ab, bei dem es sich um einen hochauflösenden Zeitstempel (<1us) handelt, der für Zeitintervallmessungen verwendet werden kann.

Syntax

BOOL QueryPerformanceCounter(
  [out] LARGE_INTEGER *lpPerformanceCount
);

Parameter

[out] lpPerformanceCount

Ein Zeiger auf eine Variable, die den aktuellen Leistungsindikatorwert in Anzahl empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

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.

Beispiele

// Gets the current number of ticks from QueryPerformanceCounter. Throws an
// exception if the call to QueryPerformanceCounter fails.
static inline int64_t GetTicks()
{
    LARGE_INTEGER ticks;
    if (!QueryPerformanceCounter(&ticks))
    {
        winrt::throw_last_error();
    }
    return ticks.QuadPart;
}

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