KeQueryPerformanceCounter 函式 (ntifs)

KeQueryPerformanceCounter 常式會捕獲效能計數器的目前值和頻率。

使用 KeQueryPerformanceCounter 取得高解析度 (<1 µ s) 時間間隔測量的時間戳記。

語法

NTHALAPI LARGE_INTEGER KeQueryPerformanceCounter(
  [out, optional] PLARGE_INTEGER PerformanceFrequency
);

參數

[out, optional] PerformanceFrequency

指標,指向 KeQueryPerformanceCounter 寫入效能計數器頻率的變數,以每秒的刻度為單位。 這個參數是選擇性的,如果呼叫端不需要計數器頻率值,則可以是 Null。

傳回值

KeQueryPerformanceCounter 會傳回效能計數器值(以刻度為單位)。

備註

KeQueryPerformanceCounter 會傳回64位整數,表示高解析度單純 nondecreasing 計數器的目前值。

若要取得效能計數器的頻率,請為 PerformanceFrequency 參數指定非 Null 指標值。 效能計數器的頻率是在系統開機時固定,而且在所有處理器之間都是一致的。 因此,驅動程式可以在初始化期間快取效能計數器的頻率。

如需此函式和其使用方式的詳細資訊,請參閱取得 高解析度的時間戳記

規格需求

   
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 通用
標頭 ntifs (包含 Wdm、Ntddk .h、Ntifs .h)
程式庫 Hal .lib
DLL Hal.dll
IRQL 任何層級

另請參閱

KeQueryInterruptTime

KeQueryTickCount

KeQueryTimeIncrement

QueryPerformanceCounter

QueryPerformanceFrequency