KeQueryPerformanceCounter 関数 (wdm.h)

[アーティクル]
08/08/2023

KeQueryPerformanceCounter ルーチンは、パフォーマンスカウンターの現在の値と頻度を取得します。

KeQueryPerformanceCounter を使用して、時間間隔測定用の高解像度 (<1μs) タイムスタンプを取得します。

構文

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

パラメーター

[out, optional] PerformanceFrequency

KeQueryPerformanceCounter がパフォーマンスカウンターの頻度を 1 秒あたりのティック数で書き込む変数へのポインター。このパラメーターは省略可能であり、呼び出し元がカウンター頻度値を必要としない場合は NULL にすることができます。

戻り値

KeQueryPerformanceCounter は 、パフォーマンスカウンターの値をティック単位で返します。

注釈

KeQueryPerformanceCounter は、高解像度の単調非宣言カウンターの現在の値を表す 64 ビットの整数を返します。

パフォーマンスカウンターの頻度を取得するには、PerformanceFrequency パラメーターに NULL 以外のポインター値を指定します。パフォーマンスカウンターの頻度はシステムの起動時に固定され、すべてのプロセッサで一貫しています。そのため、ドライバーは、初期化中にパフォーマンスカウンターの頻度をキャッシュできます。

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

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	Hal.lib
[DLL]	Hal.dll
IRQL	任意のレベル