KeQueryInterruptTime 函式 (wdm.h)

發行項
02/27/2024

KeQueryInterruptTime 例程會傳回系統中斷時間計數的目前值，精確度為在系統時鐘刻度內。

Syntax

ULONGLONG KeQueryInterruptTime();

傳回值

KeQueryInterruptTime 會以 100 奈秒單位傳回目前的中斷時間計數。此傳回值的更新通常會在每個系統時鐘刻度中至少發生一次。

備註

此例程會傳回系統中斷時間，這是上次啟動作業系統以來的時間量。當操作系統啟動時，中斷時間計數會從零開始，而且會以時鐘刻度長度遞增每個時鐘中斷。基於各種原因，例如硬體差異，系統時鐘刻度長度可能會因計算機而異。呼叫 KeQueryTimeIncrement 例程來判斷系統時鐘刻度的大小。

KeQueryInterruptTime 可用於效能微調。此例程會傳回比 KeQueryTickCount 例程更精細的度量。對 KeQueryInterruptTime 的呼叫，其額外負荷遠低於對 KeQueryPerformanceCounter 例程的呼叫。

因此，當系統執行時，中斷時間可以用來測量非常精細的持續時間，因為設定或重設系統時間的作業不會影響系統中斷時間計數。

不過，電源管理狀態變更會影響系統中斷時間計數。中斷時間計數的維護會在系統睡眠狀態期間暫停。發生後續喚醒狀態轉換時，系統會將「偏差」值新增至中斷時間計數，以補償這類睡眠狀態的估計持續時間。 KeQueryInterruptTime 所傳回的中斷時間計數包含此偏差值。若要取得不偏差的中斷時間計數，請使用 KeQueryUnbiasedInterruptTime 例程，而不是 KeQueryInterruptTime。

規格需求

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	任何層級