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


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

Подпрограмма 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 должна находиться в непагрегированной памяти.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть portcls.h (включая Portcls.h)

См. также раздел

IMiniport::GetDescription

IPortEvents::AddEventToEventList

IPortEvents::GenerateEventList

PCAUTOMATION_TABLE

PCEVENT_ITEM

PCEVENT_REQUEST

PCFILTER_DESCRIPTOR