QueryUnbiasedInterruptTimePrecise 函数（realtimeapiset.h）

项目
09/26/2024

获取与 queryUnbiasedInterruptTime 相比，以更精确的形式获取当前的无偏中断时间计数。无偏见的中断时间计数不包括系统在睡眠或休眠中花费的时间。

语法

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

参数

[out] lpUnbiasedInterruptTimePrecise

指向 ULONGLONG 的指针，用于接收系统时间单位为 100 纳秒的无偏差中断时间计数。除以 1000 万（即 1e7）以获得秒（每秒有 1e9 纳秒，因此每秒有 1e7 100 纳秒）。

返回值

没有

言论

QueryUnbiasedInterruptTimePrecise 类似于 QueryUnbiasedInterruptTime 例程，但更精确。 QueryUnbiasedInterruptTime 报告的中断时间基于系统时钟计时器的最新时钟周期。系统时钟计时器是定期为系统时钟生成中断的硬件计时器。系统时钟计时器中断之间的统一周期称为系统时钟计时周期，通常介于 0.5 毫秒到 15.625 毫秒之间，具体取决于硬件平台。 QueryUnbiasedInterruptTime 检索的中断时间值在系统时钟周期内准确。

若要提供比 QueryUnbiasedInterruptTime更精确的系统时间值，QueryUnbiasedInterruptTimePrecise 直接读取计时器硬件，因此，QueryUnbiasedInterruptTimePrecise 调用的速度可能比 QueryUnbiasedInterruptTime 调用慢。

调用 KeQueryTimeIncrement 例程来确定系统时钟周期的持续时间。

另请参阅 QueryUnbiasedInterruptTime中的备注。

注释QueryUnbiasedInterruptTimePrecise 函数在 Windows 的调试（“checked”）生成时生成不同的结果，因为中断时间计数和时钟周期计数在大约 49 天内会提前。这有助于识别在系统长时间运行之前可能不会发生的 bug。

若要编译使用此函数的应用程序，请将_WIN32_WINNT定义为0x0601或更高版本。有关详细信息，请参阅使用 Windows 标头。

要求

要求	价值
最低支持的客户端	Windows 10 [桌面应用 \|UWP 应用]
支持的最低服务器	Windows Server 2016 [桌面应用 \|UWP 应用]
目标平台	窗户
标头	realtimeapiset.h
库	mincore.lib
DLL	Kernel32.dll