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 |