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

Статья
03/05/2024

Подсистема фильтрации вызывает функцию выноски completionFn выноски всякий раз, когда данные пакетов, описанные параметром netBufferList в одной из функций внедрения пакетов, были внедрены в сетевой стек.

Синтаксис

FWPS_INJECT_COMPLETE0 FwpsInjectComplete0;

void FwpsInjectComplete0(
  [in]      void *context,
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      BOOLEAN dispatchLevel
)
{...}

Параметры

[in] context

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

[in, out] netBufferList

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

[in] dispatchLevel

Значение типа , указывающее IRQL, при котором вызывается функция выноски completionFn . Если этот параметр имеет значение TRUE, функция выноски completionFn вызывается в IRQL = DISPATCH_LEVEL. Если этот параметр имеет значение FALSE, функция выноски completionFn вызывается на DISPATCH_LEVEL IRQL < .

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

None

Remarks

Тип FWPS_INJECT_COMPLETE0 определяется как указатель на функцию completionFn следующим образом:

typedef void (NTAPI *FWPS_INJECT_COMPLETE0) completionFn

Элемент Status структуры NET_BUFFER_LIST , на который указывает NetBufferList , указывает результат операции внедрения.

После того как данные пакета в клонированных или созданных NET_BUFFER_LIST цепочке структуры успешно внедрены в сетевой стек одной из функций внедрения пакетов, вызывается метод completionFn .

Если функция FwpsStreamInjectAsync0 вызывается для внедрения цепочки NET_BUFFER_LIST структур, completionFn будет вызываться один раз для каждого NET_BUFFER_LIST в цепочке, каждый раз с использованием одного и того же параметра completionContext , указанного в FwpsStreamInjectAsync0. В этом случае реализация драйвера выноски completionFn должна вызвать FwpsFreeCloneNetBufferList0 , чтобы освободить указанный в данный момент NET_BUFFER_LIST.

Модуль фильтрации вызывает функцию выноски завершенияFn в IRQL <= DISPATCH_LEVEL.

Требования

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