структура 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). В противном случае выполняется проверка обычной ошибки.
Замечания
Параметр параметров подпрограммы exSetTime r — это указатель на структуру EXT_SET_PARAMETERS. Перед передачей структуры EXT_SET_PARAMETERS этой подпрограмме вызовите подпрограмму ExInitializeSetTimerParameters подпрограмму для инициализации структуры.
Подпрограмма ExInitializeSetTimerParameters задает NoWakeTolerance член равным нулю, что означает, что таймер немедленно просыпается, если таймер достигает срока действия, когда процессор находится в состоянии низкой мощности. Чтобы уменьшить потребление энергии, драйвер может задать для этого элемента ненулевое значение, чтобы продлить время, которое процессор тратит в состоянии низкой мощности.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается начиная с Windows 8.1. |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |