KeConvertPerformanceCounterToAuxiliaryCounter 函式 (wdm.h)

  • 發行項

KeConvertPerformanceCounterToAuxiliaryCounter 例程會將指定的性能計數器值轉換成輔助計數器值。

語法

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

參數

[in] PerformanceCounterValue

要轉換的性能計數器值。

[out] AuxiliaryCounterValue

包含已轉換輔助計數器值的變數指標。

[out, optional] ConversionError

變數的指標，其中包含以奈秒為單位的估計轉換錯誤。

傳回值

KeConvertPerformanceCounterToAuxiliaryCounter 可以傳回下列其中一項：

傳回碼 Description
STATUS_SUCCESS
 轉換成功。
STATUS_NOT_SUPPORTED
 不支持輔助計數器。
STATUS_INVALID_PARAMETER
PerformanceCounterValue 值無效。 例如，值早於最後一個系統開機/復原，或超出 +/- 10s 範圍，相較於目前的性能計數器值。
STATUS_UNSUCCESSFUL
例程無法以可接受的精確度轉換指定的值。

備註

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

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

規格需求

需求 值
最低支援的用戶端 從 Windows 10 開始提供。
目標平台 Universal
標頭 wdm.h
程式庫 Ntoskrnl.lib
Dll Hal.dll
IRQL 任何層級

另請參閱

KeConvertAuxiliaryCounterToPerformanceCounter