QueryInterruptTimePrecise 函数（realtimeapiset.h）

项目
07/16/2024

获取当前中断时间计数，其格式比 queryInterruptTime 更精确。

语法

void QueryInterruptTimePrecise(
  [out] PULONGLONG lpInterruptTimePrecise
);

参数

[out] lpInterruptTimePrecise

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

返回值

没有

言论

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

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

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

另请参阅 QueryInterruptTime中的备注。

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

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

要求

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