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