структура FWPS_TRANSPORT_SEND_PARAMS0 (fwpsk.h)

Статья
08/07/2023

Структура FWPS_TRANSPORT_SEND_PARAMS0 определяет свойства исходящего пакета транспортного уровня.

Обратите вниманиеFWPS_TRANSPORT_SEND_PARAMS0 является конкретной версией FWPS_TRANSPORT_SEND_PARAMS, используемой в Windows Vista и более поздних версиях. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows . Для Windows 7 доступно FWPS_TRANSPORT_SEND_PARAMS1 .

Синтаксис

typedef struct FWPS_TRANSPORT_SEND_PARAMS0_ {
  UCHAR      *remoteAddress;
  SCOPE_ID   remoteScopeId;
  WSACMSGHDR *controlData;
  ULONG      controlDataLength;
} FWPS_TRANSPORT_SEND_PARAMS0;

Члены

remoteAddress

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

Буфер может содержать IPv4-адрес (4 байта) или IPv6-адрес (16 байт), и адрес должен быть указан в порядке байтов сети. Версия IP-адреса должна соответствовать параметру AddressFamily, указанному вФункция FwpsInjectTransportSendAsync0.

Буфер должен оставаться действительным до вызова функции завершения внедрения.

remoteScopeId

Структура SCOPE_ID, содержащая идентификатор область для удаленного IP-адреса. Идентификатор область предоставляется в выноску через элемент remoteScopeId FWPS_INCOMING_METADATA_VALUES0 структуры, передаваемой функции выноски classifyFn драйвера выноски. Структура SCOPE_ID определена в Ws2ipdef.h следующим образом.

typedef struct {
  union {
    struct {
      ULONG  Zone : 28;
      ULONG  Level : 4;
    };
    ULONG  Value;
  };
} SCOPE_ID, *PSCOPE_ID;

controlData

Необязательный указатель на буфер, содержащий данные управления сокетом, указанные функцией WSASendMsg . Сведения о типе WSACMSGHDR см. в разделе CMSGHDR.

При наличии данные элемента управления сокета предоставляются в выноску с элементом controlData FWPS_INCOMING_METADATA_VALUES0 структуры, передаваемой функции выноски classifyFn драйвера выноски.

Если данные управления сокетом не равно NULL, их необходимо скопировать в реализацию функции classifyFn драйвера выноски, а буфер controlData должен оставаться действительным до вызова функции завершения внедрения.

controlDataLength

Длина элемента controlData в байтах.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows Vista.
Верхняя часть	fwpsk.h (включая Fwpsk.h)

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

CMSGHDR

FWPS_INCOMING_METADATA_VALUES0

FWPS_TRANSPORT_SEND_PARAMS1

FwpsInjectTransportSendAsync0

WSASendMsg

classifyFn

Поделиться через