Freigeben über


timeGetTime-Funktion (timeapi.h)

Die timeGetTime-Funktion ruft die Systemzeit in Millisekunden ab. Die Systemzeit ist die Zeit, die seit dem Start von Windows verstrichen ist.

Syntax

DWORD timeGetTime();

Rückgabewert

Gibt die Systemzeit in Millisekunden zurück.

Hinweise

Der einzige Unterschied zwischen dieser Funktion und der timeGetSystemTime-Funktion besteht darin, dass timeGetSystemTime die MMTIME-Struktur verwendet, um die Systemzeit zurückzugeben. Die timeGetTime-Funktion hat weniger Aufwand als timeGetSystemTime.

Beachten Sie, dass der von der timeGetTime-Funktion zurückgegebene Wert ein DWORD-Wert ist. Der Rückgabewert wird alle 2^32 Millisekunden auf 0 umbrochen, was etwa 49,71 Tagen entspricht. Dies kann Probleme im Code verursachen, der den timeGetTime-Rückgabewert direkt in Berechnungen verwendet, insbesondere wenn der Wert zum Steuern der Codeausführung verwendet wird. Sie sollten immer den Unterschied zwischen zwei timeGetTime-Rückgabewerten in Berechnungen verwenden.

Die Standardgenauigkeit der timeGetTime-Funktion kann je nach Computer fünf Millisekunden oder mehr betragen. Sie können die Funktionen timeBeginPeriod und timeEndPeriod verwenden, um die Genauigkeit von timeGetTime zu erhöhen. Wenn Sie dies tun, kann die minimale Differenz zwischen aufeinander folgenden Werten, die von timeGetTime zurückgegeben werden, so groß sein wie der minimale Zeitraumwert, der mithilfe von timeBeginPeriod und timeEndPeriod festgelegt wurde. Verwenden Sie die Funktionen QueryPerformanceCounter und QueryPerformanceFrequency , um kurze Zeitintervalle mit hoher Auflösung zu messen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile timeapi.h (Windows.h einschließen)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

Multimedia-Timerfunktionen

Multimedia-Timer