KeQueryInterruptTimePrecise 函数 (wdm.h)

KeQueryInterruptTimePrecise 例程返回系统中断时间计数的当前值，准确度在微秒内。

语法

ULONG64 KeQueryInterruptTimePrecise(
  [out] PULONG64 QpcTimeStamp
);

参数

[out] QpcTimeStamp

指向ULONG64变量的指针，例程在其中写入用于内插返回值的性能计数器值。

返回值

当前中断时间计数（以 100 纳秒为单位）。

注解

KeQueryInterruptTimePrecise 返回系统的当前中断时间，即自上次启动操作系统以来的时间量。 KeQueryInterruptTimePrecise 类似于 KeQueryInterruptTime 例程，但更精确。

KeQueryInterruptTime 报告的中断时间基于系统时钟计时器的最新时钟周期。 时钟计时器是定期为系统时钟生成中断的硬件计时器。 时钟计时器中断之间的统一时间段称为系统时钟周期，通常介于 500 微秒到 15.625 毫秒之间，具体取决于硬件平台。 KeQueryInterruptTime 检索的中断时间值在系统时钟周期内准确。

为了提供比 KeQueryInterruptTime 更精确的中断时间值， KeQueryInterruptTimePrecise 使用系统性能计数器来测量自上次时钟计时器中断以来经过的时间，并将此时间添加到与最新时钟时间关联的中断时间。 KeQueryInterruptTimePrecise 报告的中断时间准确到微秒内。

在某些硬件平台上， KeQueryInterruptTimePrecise 调用可能比 KeQueryInterruptTime 调用慢。 原因是 KeQueryInterruptTimePrecise 读取性能计数器，这可能会引入额外的延迟。 有关详细信息，请参阅 KeQueryPerformanceCounter。

调用 KeQueryTimeIncrement 例程以确定系统时钟刻度的大小。

精确的中断时间可用于测量系统运行时非常精细的持续时间，因为设置或重置系统时间的操作对系统中断时间计数没有影响。

但是，电源管理状态更改会影响系统中断时间计数。 中断时间计数的维护在系统睡眠状态期间暂停。 发生后续唤醒状态转换时，系统会向中断时间计数添加“偏差”值，以补偿此类睡眠状态的估计持续时间。 KeQueryInterruptTimePrecise 返回的中断时间计数包括此偏差值。 若要获取无偏差中断时间计数，请使用 KeQueryUnbiasedInterruptTime。 目前没有精确版本的无偏差中断时间计数。

要求

要求	值
最低受支持的客户端	从Windows 8.1开始可用。
目标平台	通用
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	任何级别

另请参阅

获取高分辨率时间戳

KeQueryInterruptTime

KeQueryTimeIncrement

KeQueryUnbiasedInterruptTime