共用方式為


timeGetTime 函式 (timeapi.h)

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

Syntax

DWORD timeGetTime();

傳回值

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

備註

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

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

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

規格需求

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

另請參閱

多媒體定時器函式

多媒體定時器