共用方式為


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
例程無法以可接受的精確度轉換指定的值。

言論

請確定指定的效能計數器值為:

  • 相較於目前的性能計數器讀取值,在 +/- 10 秒內。
  • 不早於上次系統開機或從 S3/S4 狀態復原的記錄性能計數器值。
ConversionError 值是輔助計數器預期計算值與實際計算值之間的差異。 如果 ConversionError 值大於預期的值(由您決定),請再次呼叫例程。

要求

要求 價值
最低支援的用戶端 從 Windows 10 開始提供。
目標平臺 普遍
標頭 wdm.h
連結庫 Ntoskrnl.lib
DLL Hal.dll
IRQL 任何層級

另請參閱

KeConvertAuxiliaryCounterToPerformanceCounter