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

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

Синтаксис

PHW_EVENT_ROUTINE PhwEventRoutine;

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

Параметры

[in] EventDescriptor

Описывает событие и его включение или отключение.

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

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

Комментарии

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

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

Требования