KeConvertPerformanceCounterToAuxiliaryCounter 関数 (wdm.h)

  • [アーティクル]

KeConvertPerformanceCounterToAuxiliaryCounter ルーチンは、指定されたパフォーマンス カウンター値を補助カウンター値に変換します。

構文

NTSTATUS KeConvertPerformanceCounterToAuxiliaryCounter(
  [in]            ULONG64  PerformanceCounterValue,
  [out]           PULONG64 AuxiliaryCounterValue,
  [out, optional] PULONG64 ConversionError
);

パラメーター

[in] PerformanceCounterValue

変換するパフォーマンス カウンター値。

[out] AuxiliaryCounterValue

変換された補助カウンター値を含む変数へのポインター。

[out, optional] ConversionError

ナノ秒単位の推定変換エラーを含む変数へのポインター。

戻り値

KeConvertPerformanceCounterToAuxiliaryCounter は、次のいずれかを返すことができます。

リターン コード 説明
STATUS_SUCCESS
 変換に成功しました。
STATUS_NOT_SUPPORTED
 補助カウンターはサポートされていません。
STATUS_INVALID_PARAMETER
PerformanceCounterValue 値が無効です。 たとえば、値が最後のシステムの起動/回復より前であるか、現在のパフォーマンス カウンター値と比較して +/- 10s の範囲から外れているとします。
STATUS_UNSUCCESSFUL
ルーチンは、指定された値を許容できる精度で変換できません。

注釈

指定したパフォーマンス カウンター値が次の値であることを確認します。

  • 現在のパフォーマンス カウンターの読み取り値と比較して +/- 10s 以内。
  • S3/S4 状態からの最後のシステム ブートまたは回復時に記録されたパフォーマンス カウンター値より前ではありません。
ConversionError 値は、予想される計算値と補助カウンターの実際の計算値との差 (ナノ秒単位) です。 ConversionError 値が (ユーザーが決定した) 期待値より大きい場合は、ルーチンをもう一度呼び出します。

要件

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

こちらもご覧ください

KeConvertAuxiliaryCounterToPerformanceCounter