Поделиться через

структура 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 устанавливает для этого элемента значение 0.

NoWakeTolerance

Максимальное время в системных единицах времени (100-наносекундные интервалы), в течение которых таймер может ожидать пробуждения процессора после достижения времени истечения срока действия таймера. Срок действия таймера истекает только после пробуждения процессора. Если таймер истекает, когда процессор находится в состоянии с низким энергопотреблением, таймер не будет разбудить процессор до истечения срока действия, а также задержки NoWakeTolerance . В качестве параметра драйвер может задать для этого элемента значение EX_TIMER_UNLIMITED_TOLERANCE, что означает, что таймер никогда не выводит процессор из спящего режима и, следовательно, не может истечь до тех пор, пока процессор не выбудется по какой-либо другой причине.

Не устанавливайте для этого элемента отрицательное значение (кроме EX_TIMER_UNLIMITED_TOLERANCE). В противном случае выполняется обычная проверка ошибок.

Комментарии

Параметр Parameters подпрограммы ExSetTimer является указателем на структуру EXT_SET_PARAMETERS . Перед передачей структуры EXT_SET_PARAMETERS в эту подпрограмму вызовите подпрограмму ExInitializeSetTimerParameters для инициализации структуры.

Подпрограмма ExInitializeSetTimerParameters устанавливает элемент NoWakeTolerance равным нулю, что означает, что таймер немедленно выводит процессор, если таймер достигает своего срока действия, когда процессор находится в состоянии с низким энергопотреблением. Чтобы уменьшить энергопотребление, драйвер может задать этому элементу ненулевое значение, чтобы продлить время, которое процессор тратит в маломощном состоянии.

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 8.1.
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)

См. также раздел

ExInitializeSetTimerParameters

ExSetTimer