QueryPerformanceFrequency 函式 (profileapi.h)

擷取性能計數器的頻率。 性能計數器的頻率會在系統開機時固定,而且在所有處理器上都是一致的。 因此,只有在應用程式初始化時才需要查詢頻率,而且可以快取結果。

語法

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

參數

[out] lpFrequency

以每秒計數為單位接收目前性能計數器頻率之變數的指標。 如果已安裝的硬體不支援高解析度性能計數器,則此參數可以是零, (執行 Windows XP 或更新版本的系統上不會發生此參數) 。

傳回值

如果已安裝的硬體支援高解析度性能計數器,傳回值為非零。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。 在執行 Windows XP 或更新版本的系統上,函式一律會成功,因此永遠不會傳回零。

備註

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

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 profileapi.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

取得高解析度時間戳記

概念

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceCounter

參考

時間

計時器