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 | 任何级别 |