Функция KePulseEvent (ntddk.h)

Статья
08/07/2023

Подпрограмма KePulseEvent атомарно устанавливает объект события в состояние сигнала, пытается удовлетворить как можно больше ожиданий, а затем сбрасывает объект события в состояние без сигнала.

Синтаксис

LONG KePulseEvent(
  [in, out] PRKEVENT  Event,
  [in]      KPRIORITY Increment,
  [in]      BOOLEAN   Wait
);

Параметры

[in, out] Event

Указатель на объект диспетчера типа KEVENT.

[in] Increment

Указывает повышение для применения к приоритету потоков, которые готовы в результате пульсации события. Обычно устанавливается равным нулю, но может быть задано значение 1.

[in] Wait

Указывает логическое значение, указывающее, будет ли вызов KePulseEvent немедленно сопровождаться вызовом одной из подпрограмм KeWaitXxx . Если задано значение TRUE, за вызовом KePulseEvent сразу же следует вызов KeWaitForMultipleObjects, KeWaitForMutexObject или KeWaitForSingleObject. Дополнительные сведения см. в разделе "Примечания".

Возвращаемое значение

Предыдущее состояние сигнала объекта события.

Подпрограмма KePulseEvent может временно вызвать IRQL. Если параметр Wait имеет значение FALSE, подпрограмма перед возвратом восстанавливает irQL до исходного значения, которое было в начале вызова.

Если значение Wait = TRUE, подпрограмма возвращает без понижения значения IRQL. В этом случае за вызовом KePulseEvent должен следовать вызов KeWaitXxx . Установив значение Wait = TRUE, вызывающий объект может предотвратить ненужное переключение контекста между вызовом KePulseEvent и вызовом KeWaitXxx . Подпрограмма KeWaitXxx перед возвратом восстанавливает исходное значение IRQL в начале вызова KePulseEvent . Хотя IRQL отключает переключения контекста между двумя вызовами, эти вызовы нельзя надежно использовать в качестве начала и окончания атомарной операции. Например, между этими двумя вызовами поток, выполняющийся одновременно на другом процессоре, может изменить состояние объекта события или целевого объекта ожидания.

Если вызывающий объект выполняется в irQL = DISPATCH_LEVEL или в произвольном контексте потока, параметр Timeout для KeWaitXxx должен быть равен нулю.

Предупреждение

Если поток, ожидающий события, в настоящее время выполняет ядро APC, то при вызове KePulseEvent ожидание этого потока не выполняется. После завершения APC ядра поток остается в состоянии ожидания.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	ntddk.h (включая Ntddk.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm)