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

Функция обратного вызова PKTMON_PROVIDER_ADD_EDGE вызывается приложением PktMonClnt для добавления края в зарегистрированный компонент. Ребра представляет границу мониторинга пакетов (точка входа и выхода), в которой пакеты передаются через компонент, позволяя компоненту сообщать о событиях пакетов с определенными границами.

Синтаксис

PKTMON_PROVIDER_ADD_EDGE PktmonProviderAddEdge;

NTSTATUS PktmonProviderAddEdge(
  VOID *ProviderBindingContext,
  HANDLE CompHandle,
  const PKTMON_EDGE_IN *Edge,
  HANDLE *EdgeHandle
)
{...}

Параметры

ProviderBindingContext

Непрозрачный указатель контекста, представляющий привязку поставщика. Этот контекст определяет конкретный экземпляр поставщика, обрабатывая эту операцию.

CompHandle

Дескриптор компонента, к которому будет добавлен край. Этот дескриптор был возвращен из предыдущего вызова PKTMON_PROVIDER_REGISTER_COMPONENT обратного вызова.

Edge

Указатель на структуру PKTMON_EDGE_IN , содержащую сведения о добавленном крае, включая его имя и тип пакета.

EdgeHandle

Указатель на дескриптор, который получает пограничный дескриптор при успешном добавлении. Этот дескриптор используется при ведении журнала или отчетности о событиях пакетов на этом крае.

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

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

Замечания

Этот обратный вызов является частью структуры PKTMON_PROVIDER_DISPATCH и вызывается приложением PktMonClnt. Компоненты могут иметь несколько ребер, представляющих разные точки мониторинга.

Требования

См. также

• PKTMON_EDGE_IN
• PKTMON_PROVIDER_DISPATCH
• PktMonClntAddEdge