estrutura FWPS_TRANSPORT_SEND_PARAMS0 (fwpsk.h)

Artigo
03/01/2024

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

ObserveFWPS_TRANSPORT_SEND_PARAMS0 é a versão específica do FWPS_TRANSPORT_SEND_PARAMS usado no Windows Vista 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 7, FWPS_TRANSPORT_SEND_PARAMS1 está disponível.

Sintaxe

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

Membros

remoteAddress

Um ponteiro para um buffer que especifica o endereço IP remoto para o qual enviar o soquete. 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 FwpsInjectTransportSendAsync0 .

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 .