Функция FwpsInjectForwardAsync0 (fwpsk.h)

Статья
08/07/2023

Функция FwpsInjectForwardAsync0 внедряет данные пакета в путь к данным пересылки.

ПримечаниеFwpsInjectForwardAsync0 — это определенная версия FwpsInjectForwardAsync. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows .

Синтаксис

NTSTATUS FwpsInjectForwardAsync0(
  [in]           HANDLE                injectionHandle,
  [in, optional] HANDLE                injectionContext,
  [in]           UINT32                flags,
  [in]           ADDRESS_FAMILY        addressFamily,
  [in]           COMPARTMENT_ID        compartmentId,
  [in]           IF_INDEX              interfaceIndex,
  [in, out]      NET_BUFFER_LIST       *netBufferList,
  [in]           FWPS_INJECT_COMPLETE0 completionFn,
  [in, optional] HANDLE                completionContext
);

Параметры

[in] injectionHandle

Дескриптор внедрения, ранее созданный вызовомФункция FwpsInjectionHandleCreate0.

[in, optional] injectionContext

Необязательный дескриптор контекста внедрения. Если этот параметр указан, его можно получить, вызвав Функция FwpsQueryPacketInjectionState0 , когда состояние внедрения пакетов FWPS_PACKET_INJECTION_STATEFWPS_PACKET_INJECTED_BY_SELF или FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF.

[in] flags

Зарезервировано. Драйверы выносок должны задать для этого параметра нулевое значение.

[in] addressFamily

Одно из следующих семейств адресов:

AF_INET

Семейство адресов IPv4.

AF_INET6

Семейство адресов IPv6.

[in] compartmentId

Идентификатор секции маршрутизации, в которую внедряются данные пакета, указанный в качестве типа COMPARTMENT_ID . Этот идентификатор предоставляется выноске через элемент compartmentId элемента FWPS_INCOMING_METADATA_VALUES0 структуры, передаваемой функции выноски classifyFn драйвера выноски. Если элемент compartmentId доступен для выносок, FWPS_METADATA_FIELD_COMPARTMENT_ID будет задан в элементе currentMetadataValues . В противном случае задайте для этого параметра значение UNSPECIFIED_COMPARTMENT_ID.

[in] interfaceIndex

Индекс интерфейса назначения (по которому отправляются данные пакета). Индекс является 32-разрядным значением. Драйвер выноски должен использовать значение индекса интерфейса, которое передается в качестве одного из входящих значений данных в функцию выноски classifyFn для этого параметра, если пакет должен быть внедрен в тот же интерфейс, где указан исходный пакет.

[in, out] netBufferList

Указатель на структуру NET_BUFFER_LIST , описывающую внедряемые данные пакета. Драйвер выноски выделяет структуру NET_BUFFER_LIST для внедрения данных пакетов путем вызова Функция FwpsAllocateCloneNetBufferList0 или Функция FwpsAllocateNetBufferAndNetBufferList0 . Структура NET_BUFFER_LIST должна начинаться с ip-заголовка.

[in] completionFn

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

[in, optional] completionContext

Указатель на предоставленный драйвером выноски контекст, который передается в функцию выноски, на которую указывает параметр completionFn . Этот параметр является необязательным и может иметь значение NULL.

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

Функция FwpsInjectForwardAsync0 возвращает один из следующих кодов NTSTATUS.

Код возврата	Описание
STATUS_SUCCESS	Внедрение данных пакета было успешно инициировано. Модуль фильтрации вызывает функцию завершения после завершения модуля фильтрации, вставки данных пакета в сетевой стек или при последующей ошибке. В этом случае элемент Status завершенной NET_BUFFER_LIST структуры укажет причину сбоя.
STATUS_FWP_TCPIP_NOT_READY	Сетевой стек TCP/IP не готов принимать внедрение данных пакетов.
STATUS_FWP_INJECT_HANDLE_CLOSING	Маркер внедрения закрывается.
Другие коды состояния	Произошла ошибка.

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

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

Если возвращаемое значение не STATUS_SUCCESS, функция завершения вызываться не будет. В этом случае список чистого буфера, на который указывает netBufferList , должен быть освобожден вызовом FwpsFreeNetBufferList0 или FwpsFreeCloneNetBufferList0.

IP-пакеты или фрагменты можно клонировать, изменять и внедрять обратно в сетевой стек. Однако перед повторной сборкой группы фрагментов драйвером выноски необходимо выполнить повторную сборку в виде одного NET_BUFFER_LIST.

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

Требования

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