wdm.h) (EXT_SET_PARAMETERS 结构

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