Программирование драйверов Windows

         

Для использования объекта события сначала


Таблица 10.26. Функции для работы с объектами событий

Что необходимо сделать... Какой вызов нужно использовать...
Создать событие KeInitializeEvent
Создать именованное событие IoCreateSynchronizationEvent

IoCreateNotificationEvent
Изменить состояние события KeSetEvent

KeClearEvent

KeResetEvent
Запросить состояние KeReadStateEvent
Для использования объекта события сначала необходимо получить память для его хранения размером sizeof(KEVENT), и только после этого можно выполнять вызовы функций, перечисленные выше. Рассмотрим некоторые из них.

Несигнальное состояние объекта событий можно установить при помощи вызовов KeResetEvent и KeClearEvent. Разница между ними заключается в том, что функция KeResetEvent еще и возвращает состояние объекта, в котором тот пребывал перед данным вызовом. Функция KeClearEvent

работает несколько быстрее, поэтому в тех случаях, когда нет необходимости знать предыдущее состояние объекта, следует использовать этот вызов.

Таблица 10.27. Прототип вызова KeInitializeEvent

VOID KeInitializeEvent IRQL == PASSIVE_LEVEL
Параметры Инициализация объекта события и установка его начального состояния
IN PKEVENT pEvent Указатель на область памяти для объекта события
IN EVENT_TYPE Type Одно из двух значений

• NotificationEvent

• SynchronizationEvent
IN BOOLEAN bInitalState Начальное состояние объекта

• TRUE &#8212 сигнальное состояние

• FALSE &#8212 несигнальное состояние
Возвращаемое значение void
Таблица 10.28. Прототип вызовов KeClearEvent

u KeResetEvent

VOID KeClearEvent

LONG KeResetEvent 		IRQL &#60= DISPATCH_LEVEL
Параметры Установка объекта события в несигнальное состояния
IN PKEVENT pEvent Указатель на инициализированный объект события
Возвращаемое значение KeResetEvent возвращает предыдущее состояние объекта события
Таблица 10.29. Прототип вызова KeSetEvent

LONG KeSetEvent IRQL &#60= DISPATCH_LEVEL
Параметры Переводит объект события в сигнальное состояние
IN PKEVENT pEvent Указатель на инициализированный объект события
IN KPRIORITY Increment Обычно используется значение IO_NO_INCREMENT
IN BOOLEAN bWait Обычно используется значение FALSE
Возвращаемое значение Возвращает ненулевое значение, если предыдущее состояние объекта события было сигнальным
<

Содержание  Назад  Вперед