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
Referenz