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

Статья
03/01/2024

Подпрограмма EventHandler обрабатывает запросы на события.

Синтаксис

PCPFNEVENT_HANDLER PcpfneventHandler;

NTSTATUS PcpfneventHandler(
  [in] PPCEVENT_REQUEST EventRequest
)
{...}

Параметры

[in] EventRequest

Указатель на инициализированную структуру PCEVENT_REQUEST

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

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

Каждое событие, предоставляемое драйвером мини-порта, связано с обработчиком событий. Обработчик событий предназначен для обработки запросов на события от драйвера порта и его клиентов. EventRequest — это входной параметр обработчика, который содержит следующие сведения о событии:

GUID набора событий и идентификатор события.
Способ активации события.
Указатели на целевой объект мини-порта и объект потока (для закрепления).

Это похоже на тип сведений, предоставляемых запросами свойств.

Драйвер мини-порта предоставляет обработчики событий с помощью метода IMiniport::GetDescription . Этот метод выводит структуру дескриптора (см . PCFILTER_DESCRIPTOR), которая определяет фильтр, который реализует драйвер мини-порта и связанный с ним драйвер порта вместе. Эта структура содержит указатель на таблицу автоматизации драйвера минипорта (см . PCAUTOMATION_TABLE), которая, в свою очередь, содержит указатель на массив событий драйвера мини-порта. Каждый элемент массива является PCEVENT_ITEM структурой и содержит указатель функции PCPFNEVENT_HANDLER на обработчик события.

Подпрограмма EventHandler должна находиться в непагрегированной памяти.