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

  • Статья

Модуль фильтрации вызывает функцию выноски flowDeleteFn выноски, чтобы уведомить выноску о том, что поток данных, обрабатываемый выноской, завершается.

Синтаксис

FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 FwpsCalloutFlowDeleteNotifyFn0;

void FwpsCalloutFlowDeleteNotifyFn0(
  [in] UINT16 layerId,
  [in] UINT32 calloutId,
  [in] UINT64 flowContext
)
{...}

Параметры

[in] layerId

Идентификатор времени выполнения для уровня фильтрации, на котором завершается поток данных. Дополнительные сведения см. в разделе Идентификаторы слоев фильтрации во время выполнения.

[in] calloutId

Идентификатор времени выполнения для выноски в обработчике фильтров. Это тот же идентификатор, который был возвращен, когда драйвер выноски вызывал функции FwpsCalloutRegister0 или FwpsCalloutRegister1 для регистрации выноски в обработчике фильтров.

[in] flowContext

Последний контекст, связанный с потоком данных путем вызова функции FwpsFlowAssociateContext0 .

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

None

Remarks

Драйвер выноски регистрирует функции выноски в обработчике фильтров, вызывая функции FwpsCalloutRegister0 или FwpsCalloutRegister1 .

Обработчик фильтров вызывает функцию выноски flowDeleteFn выноски, когда она завершает поток данных, чтобы выноска удалялась в контексте, связанном с потоком данных. Например, эта функция выноски будет вызываться после резкой остановки из RST без первого вызова classifyFn . Обработчик фильтров вызывает эту функцию выноски, только если драйвер выноски связывает контекст с потоком данных. При завершении потока данных контекст будет автоматически удален из потока данных подсистемой фильтрации.

Модуль фильтрации вызывает функцию выноски flowDeleteFn выноски, только если выноска была ранее добавлена в подсистему фильтрации на уровне фильтрации, поддерживающем потоки данных, а драйвер выноски связывает контекст с потоками данных, которые он обрабатывает. Если драйвер выноски не связывает контекст с потоками данных, которые обрабатывает выноска, он не должен реализовывать функцию выноски flowDeleteFn для выноски. В этом случае драйвер выноски должен задать
Элемент flowDeleteFnструктуры FWPS_CALLOUT0 значение NULL при регистрации выноски в обработчике фильтров.

Тип FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 определяется как указатель на функцию flowDeleteFn следующим образом.

typedef void (NTAPI *FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0) flowDeleteFn

Обработчик фильтров вызывает функцию выноски flowDeleteFn в IRQL <= DISPATCH_LEVEL.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows Vista.
Целевая платформа Windows
Header fwpsk.h (включая Fwpsk.h)
IRQL <= DISPATCH_LEVEL

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

Функции выноски драйвера выноски

FWPS_CALLOUT0

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0