EXT_SET_PARAMETERS结构(wdm.h)

EXT_SET_PARAMETERS 结构包含 ExSetTimer 例程的扩展参数集。

语法

typedef struct _EXT_SET_PARAMETERS_V0 {
  ULONG    Version;
  ULONG    Reserved;
  LONGLONG NoWakeTolerance;
} EXT_SET_PARAMETERS, *PEXT_SET_PARAMETERS;

成员

Version

EXT_SET_PARAMETERS 结构的版本号。 ExInitializeSetTimerParameters 例程将此成员设置为正确的版本号。

Reserved

设置为零。 ExInitializeSetTimerParameters 例程将此成员设置为零。

NoWakeTolerance

在系统时间单位(100 纳秒间隔)中,计时器可以等待计时器在计时器到达其过期时间后唤醒处理器。 只有在处理器唤醒后,计时器才会过期。 如果计时器设置为在处理器处于低功率状态时过期,则在过期时间加上超过 NoWakeTolerance 延迟之前,计时器不会唤醒处理器过期。 作为一个选项,驱动程序可以将此成员设置为EX_TIMER_UNLIMITED_TOLERANCE,这表示计时器永远不会唤醒处理器,因此,在处理器唤醒之前无法过期,因为其他原因。

不要将此成员设置为负值(EX_TIMER_UNLIMITED_TOLERANCE以外的值)。 否则,例程 bug 会检查。

言论

ExSetTimer 例程的 Parameters 参数是指向 EXT_SET_PARAMETERS 结构的指针。 将 EXT_SET_PARAMETERS 结构传递给此例程之前,请调用 ExInitializeSetTimerParameters 例程来初始化结构。

ExInitializeSetTimerParameters 例程将 NoWakeTolerance 成员设置为零,这意味着,如果计时器达到处理器处于低功率状态的过期时间,计时器将立即唤醒处理器。 为了降低能耗,驱动程序可以将此成员设置为非零值,以延长处理器处于低功率状态的时间。

要求

要求 价值
最低支持的客户端 从 Windows 8.1 开始支持。
标头 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另请参阅

ExInitializeSetTimerParameters

ExSetTimer