estrutura FWPS_TRANSPORT_SEND_PARAMS1 (fwpsk.h)

Artigo
02/26/2024

A estrutura FWPS_TRANSPORT_SEND_PARAMS1 define as propriedades de um pacote de camada de transporte de saída.

ObserveFWPS_TRANSPORT_SEND_PARAMS1 é a versão específica do FWPS_TRANSPORT_SEND_PARAMS usado no Windows 7 e posterior. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações. Para o Windows Vista, FWPS_TRANSPORT_SEND_PARAMS0 está disponível.

Sintaxe

typedef struct FWPS_TRANSPORT_SEND_PARAMS1_ {
  UCHAR      *remoteAddress;
  SCOPE_ID   remoteScopeId;
  WSACMSGHDR *controlData;
  ULONG      controlDataLength;
  UCHAR      *headerIncludeHeader;
  ULONG      headerIncludeHeaderLength;
} FWPS_TRANSPORT_SEND_PARAMS1;

Membros

remoteAddress

Um ponteiro para um buffer que especifica o endereço IP remoto para o qual o soquete precisa ser enviado. O endereço remoto especificado por esse membro pode ser diferente do passado como um dos valores de dados de entrada para a função de texto explicativo classifyFn do driver de texto explicativo.

O buffer pode conter um endereço IPv4 (4 bytes) ou um endereço IPv6 (16 bytes) e o endereço deve ser especificado na ordem de bytes de rede. A versão do IP deve corresponder ao parâmetro AddressFamily especificado no Função FwpsInjectTransportSendAsync1 .

O buffer deve permanecer válido até que a função de conclusão da injeção seja chamada.

remoteScopeId

Uma estrutura SCOPE_ID que contém o identificador de escopo para o endereço IP remoto. O identificador de escopo é fornecido a um texto explicativo por meio do membro remoteScopeId do FWPS_INCOMING_METADATA_VALUES0 estrutura passada para a função de texto explicativo classifyFn do driver de texto explicativo. A estrutura SCOPE_ID é definida em Ws2ipdef.h da seguinte maneira.

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

controlData

Um ponteiro opcional para um buffer que contém dados de controle de soquete especificados pela função WSASendMsg . Para obter informações sobre o tipo WSACMSGHDR , consulte CMSGHDR.

Se presentes, os dados de controle de soquete são fornecidos a um texto explicativo com o membro controlData do FWPS_INCOMING_METADATA_VALUES0 estrutura passada para a função de texto explicativo classifyFn do driver de texto explicativo.

Se os dados de controle de soquete não forem NULL, eles deverão ser copiados profundamente na implementação do driver de texto explicativo da função classifyFn e o buffer controlData deverá ser mantido válido até que a função de conclusão da injeção seja chamada.

controlDataLength

O comprimento, em bytes, do membro controlData .

headerIncludeHeader

O cabeçalho de transporte a ser incluído.

headerIncludeHeaderLength

O comprimento, em bytes, do membro headerIncludeHeader .