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) |