Freigeben über


QueryPerformanceCounter-Funktion (profileapi.h)

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

Siehe auch

Abrufen von Zeitstempeln mit hoher Auflösung

Konzept

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceFrequency

Referenz

Time

Timer