GetTickCount-Funktion (sysinfoapi.h)

Artikel
07/16/2024

Ruft die Anzahl der Millisekunden ab, die seit dem Start des Systems verstrichen sind, bis zu 49,7 Tage.

Syntax

DWORD GetTickCount();

Rückgabewert

Der Rückgabewert ist die Anzahl von Millisekunden, die seit dem Start des Systems verstrichen sind.

Bemerkungen

Die Auflösung der GetTickCount--Funktion ist auf die Auflösung des Systemzeitgebers beschränkt, der in der Regel im Bereich von 10 Millisekunden bis 16 Millisekunden liegt. Die Auflösung der funktion GetTickCount ist nicht von Anpassungen betroffen, die von der GetSystemTimeAdjustment-Funktion vorgenommen wurden.

Die verstrichene Zeit wird als DWORD--Wert gespeichert. Daher wird die Zeit um 0 umgebrochen, wenn das System für 49,7 Tage kontinuierlich ausgeführt wird. Um dieses Problem zu vermeiden, verwenden Sie die GetTickCount64--Funktion. Überprüfen Sie andernfalls beim Vergleichen von Zeiten auf eine Überlaufbedingung.

Wenn Sie einen Timer mit höherer Auflösung benötigen, verwenden Sie einen Multimediatimer oder einen hochauflösenden Timer.

Um die seit dem Start des Computers verstrichene Zeit abzurufen, rufen Sie den Systemuptime-Indikator in den Leistungsdaten im Registrierungsschlüssel HKEY_PERFORMANCE_DATAab. Der zurückgegebene Wert ist ein 8-Byte-Wert. Weitere Informationen finden Sie unter Leistungsindikatoren.

Verwenden Sie die QueryUnbiasedInterruptTime-Funktion, um die Zeit abzurufen, die das System seit dem Start in den Arbeitszustand verbracht hat.

Hinweis Die QueryUnbiasedInterruptTime--Funktion erzeugt unterschiedliche Ergebnisse für Debugbuilds ("aktiviert") von Windows, da die Unterbrechungszeitanzahl und die Teilstrichanzahl um ca. 49 Tage erweitert werden. Dadurch können Fehler identifiziert werden, die möglicherweise erst auftreten, wenn das System lange ausgeführt wurde.

Beispiele

// calculate a 't' value that will linearly interpolate from 0 to 1 and back every 20 seconds
DWORD currentTime = GetTickCount();
if ( m_startTime == 0 )
{
    m_startTime = currentTime;
}
float t = 2 * (( currentTime - m_startTime) % 20000) / 20000.0f;
if (t > 1.0f)
{
    t = 2 - t;
}

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	sysinfoapi.h (include Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll

Siehe auch

Zeitfunktionen

Windows Time

Freigeben über