QueryUnbiasedInterruptTimePrecise 函式 (realtimeapiset.h)

發行項
03/01/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 中的。

注意QueryUnbiasedInterruptTimePrecise 函式會在偵錯 (「核取」) Windows 組建上產生不同的結果，因為中斷時間計數和刻度計數大約會進階 49 天。這有助於識別在系統長時間執行之前可能不會發生的 Bug。已核取的組建可透過 Microsoft Developer Network (MSDN) 網站提供給 MSDN 訂閱者使用。

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

規格需求

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