timeGetTime 函式 (timeapi.h)

timeGetTime 函式會擷取系統時間，以毫秒為單位。 系統時間是 Windows 啟動之後經過的時間。

Syntax

DWORD timeGetTime();

傳回值

傳回系統時間，以毫秒為單位。

備註

此函式與 timeGetSystemTime 函式的唯一差異是 timeGetSystemTime 會使用 MMTIME 結構傳回系統時間。 timeGetTime 函式的額外負荷比 timeGetSystemTime 少。

請注意 ，timeGetTime 函式所傳回的值是 DWORD 值。 傳回值大約每 2^32 毫秒包裝 0，大約是 49.71 天。 這可能會導致程式代碼中直接在計算中使用 timeGetTime 傳回值的問題，特別是值用來控制程式代碼執行的位置。 您應該一律在計算中使用兩 個 timeGetTime 傳回值之間的差異。

timeGetTime 函式的預設精確度可以是五毫秒以上，視計算機而定。 您可以使用 timeBeginPeriod 和 timeEndPeriod 函式來增加 timeGetTime 的有效位數。 如果您這樣做， timeGetTime 所傳回之後續值之間的最小差異，可能會與使用 timeBeginPeriod 和 timeEndPeriod 設定的最小期間值一樣大。 使用 QueryPerformanceCounter 和 QueryPerformanceFrequency 函式，以高解析度測量短時間間隔。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	timeapi.h (包含 Windows.h)
程式庫	Winmm.lib
Dll	Winmm.dll

另請參閱

多媒體定時器函式

多媒體定時器