QueryUnbiasedInterruptTimePrecise 函式（realtimeapiset.h）

發行項
09/26/2024

以比 queryUnbiasedInterruptTime 更精確的格式取得目前不偏不偏的中斷時間計數。不偏不倚的中斷時間計數不包括系統在睡眠或休眠中花費的時間。

語法

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

參數

[out] lpUnbiasedInterruptTimePrecise

ULONGLONG 的指標，用來以 100 奈秒的系統時間單位接收不偏不偏的中斷時間計數。除以 1000 萬秒或 1e7 秒（每秒有 1e9 奈秒，因此每秒有 1e7 100 奈秒）。

傳回值

沒有

言論

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

若要提供比 QueryUnbiasedInterruptTime更精確的系統時間值，QueryUnbiasedInterruptTimePrecise 直接讀取定時器硬體，因此 QueryUnbiasedInterruptTimePrecise 呼叫速度可能會比 QueryUnbiasedInterruptTime 呼叫慢。

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

另請參閱 QueryUnbiasedInterruptTime中的備註。

NoteQueryUnbiasedInterruptTimePrecise 函式會在 Windows 的偵錯（“checked”）組建上產生不同的結果，因為中斷時間計數和刻度計數大約會進階 49 天。這有助於識別在系統長時間執行之前可能不會發生的 Bug。

若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0601或更新版本。如需詳細資訊，請參閱使用 Windows 標頭。

要求

要求	價值
最低支援的用戶端	Windows 10 [傳統型應用程式 \|UWP 應用程式]
支援的最低伺服器	Windows Server 2016 [傳統型應用程式 \|UWP 應用程式]
目標平臺	窗戶
標頭	realtimeapiset.h
連結庫	mincore.lib
DLL	Kernel32.dll