QueryPerformanceFrequency 関数 (profileapi.h)

パフォーマンス カウンターの頻度を取得します。 パフォーマンス カウンターの頻度はシステムの起動時に固定され、すべてのプロセッサで一貫しています。 したがって、頻度はアプリケーションの初期化時にのみ照会する必要があり、結果はキャッシュできます。

構文

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

パラメーター

[out] lpFrequency

現在のパフォーマンス カウンターの頻度を受け取る変数へのポインター (1 秒あたりのカウント数)。 インストールされているハードウェアが高解像度のパフォーマンス カウンターをサポートしていない場合、このパラメーターは 0 になる可能性があります (これは、Windows XP 以降を実行するシステムでは発生しません)。

戻り値

インストールされているハードウェアが高解像度のパフォーマンス カウンターをサポートしている場合、戻り値は 0 以外です。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 Windows XP 以降を実行するシステムでは、関数は常に成功するため、ゼロは返されません。

注釈

この関数とその使用方法の詳細については、「 高解像度タイム スタンプの取得」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	profileapi.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

高解像度タイム スタンプの取得

概念

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceCounter

リファレンス

Time

タイマー