共用方式為


KeQuerySystemTimePrecise 函式 (wdm.h)

KeQuerySystemTimePrecise 例程會擷取目前的 系統時間,而且比 KeQuerySystemTime 例程更精確。

語法

void KeQuerySystemTimePrecise(
  [out] PLARGE_INTEGER CurrentTime
);

參數

[out] CurrentTime

LARGE_INTEGER變數的指標,例程會寫入目前的系統時間。

傳回值

沒有

言論

系統時間是自 1601 年 1 月 1 日起的 100 奈秒間隔計數。 這個值是針對 GMT 時區計算的。 若要調整本機時區的此值,請呼叫 ExSystemTimeToLocalTime 例程。

KeQuerySystemTimePrecise 類似於 KeQuerySystemTime 例程,但更精確。 KeQuerySystemTime 所報告的系統時間 是以系統時鐘定時器的最新刻度為基礎。 時鐘定時器是定期產生系統時鐘中斷的硬體定時器。 時鐘定時器中斷之間的統一期間稱為系統時鐘刻度,而且通常取決於硬體平臺,介於 500 毫秒到 15.625 毫秒的範圍內。 KeQuerySystemTime 所擷取的系統時間值 在系統時鐘刻度內是正確的。

若要提供比 KeQuerySystemTime更精確的系統時間值,KeQuerySystemTimePrecise 會使用系統性能計數器來測量自上次時鐘定時器中斷後經過的時間,並將這個時間新增至從時鐘定時器計數計算的系統時鐘時間。 KeQuerySystemTimePrecise 所報告的系統時間 精確到微秒內。

在某些硬體平臺上,KeQuerySystemTimePrecise 呼叫速度可能會比 KeQuerySystemTime 呼叫慢。 原因是 KeQuerySystemTimePrecise 讀取性能計數器,這會造成額外的延遲。 如需詳細資訊,請參閱 KeQueryPerformanceCounter

呼叫 KeQueryTimeIncrement 例程,以判斷系統時鐘刻度的持續時間。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何層級

另請參閱

ExSystemTimeToLocalTime

KeQueryPerformanceCounter

KeQuerySystemTime

KeQueryTickCount

KeQueryTimeIncrement