通过

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
Library Ntoskrnl.lib
DLL Hal.dll
IRQL 任何级别

另请参阅

KeConvertAuxiliaryCounterToPerformanceCounter