QueryInterruptTimePrecise 函数 (realtimeapiset.h)

项目
03/04/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 函数在调试 (“checked”) Windows 版本中生成不同的结果，因为中断时间计数和时钟周期计数将提前大约 49 天。这有助于识别在系统长时间运行之前可能不会发生的 bug。选中的版本可通过 Microsoft 开发人员网络 (MSDN) 网站向 MSDN 订阅者提供。

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

要求

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