функция обратного вызова PHW_EVENT_ROUTINE (strmini.h)

Статья
02/07/2025

Драйвер класса вызывает StrMiniE vent в потоке, чтобы сигнализировать мини-driverу событие должно быть включено или отключено.

Синтаксис

PHW_EVENT_ROUTINE PhwEventRoutine;

NTSTATUS PhwEventRoutine(
  [in] IN PHW_EVENT_DESCRIPTOR EventDescriptor
)
{...}

Параметры

[in] EventDescriptor

Описывает событие и следует ли включить или отключить событие.

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

Для событий включения событий StrMiniEvent возвращает STATUS_SUCCESS, если событие успешно включено или код ошибки при сбое. Драйвер класса игнорирует возвращаемое значение при отключении запросов.

Замечания

Драйвер класса помещает структуру KSEVENT_ENTRY, которая передается в eventDescriptor—>EventEntry. Каждый другой член EventDescriptor освобожден после выхода StrMiniEvent, поэтому все данные, содержащиеся в EventData члена EventDescript or, должны храниться мини-driver.

Для этого мини-driver может выделить пространство непосредственно после структуры KSEVENT_ENTRY путем предоставления ненулевого значения в элементе ExtraEntryData элемента структуры KSEVENT_ITEM, используемой для объявления события.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	strmini.h (include Strmini.h)

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