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

Статья
08/07/2023

Функция FwpsInjectNetworkSendAsync0 внедряет данные пакета в путь отправки данных.

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

Синтаксис

NTSTATUS FwpsInjectNetworkSendAsync0(
  [in]           HANDLE                injectionHandle,
  [in, optional] HANDLE                injectionContext,
  [in]           UINT32                flags,
  [in]           COMPARTMENT_ID        compartmentId,
  [in, out]      NET_BUFFER_LIST       *netBufferList,
  [in]           FWPS_INJECT_COMPLETE0 completionFn,
  [in, optional] HANDLE                completionContext
);

Параметры

[in] injectionHandle

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

[in, optional] injectionContext

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

[in] flags

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

[in] compartmentId

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

[in, out] netBufferList

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

[in] completionFn

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

[in, optional] completionContext

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

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

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

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

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

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

Внедренный пакет можно снова указать драйверу выноски. Чтобы предотвратить бесконечные циклы, драйвер должен сначала вызвать Функция FwpsQueryPacketInjectionState0 перед продолжением вызова функции выноски classifyFn , и драйвер должен разрешить пакеты с состоянием внедрения FWPS_PACKET_INJECTION_STATE иметь значение FWPS_PACKET_INJECTED_BY_SELF или FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF.

Требования

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