FWPS_TRANSPORT_SEND_PARAMS0 structure (fwpsk.h)

Article
02/29/2024

La structure FWPS_TRANSPORT_SEND_PARAMS0 définit les propriétés d’un paquet de couche de transport sortant.

NotezFWPS_TRANSPORT_SEND_PARAMS0 est la version spécifique de FWPS_TRANSPORT_SEND_PARAMS utilisée dans Windows Vista et versions ultérieures. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows . Pour Windows 7, FWPS_TRANSPORT_SEND_PARAMS1 est disponible.

Syntaxe

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

Membres

remoteAddress

Pointeur vers une mémoire tampon qui spécifie l’adresse IP distante à laquelle envoyer le socket. L’adresse distante spécifiée par ce membre peut être différente de celle passée comme l’une des valeurs de données entrantes à la fonction de légende classifyFn du pilote de légende.

La mémoire tampon peut contenir une adresse IPv4 (4 octets) ou une adresse IPv6 (16 octets), et l’adresse doit être spécifiée dans l’ordre d’octet réseau. La version IP doit correspondre au paramètre AddressFamily spécifié dans le Fonction FwpsInjectTransportSendAsync0 .

La mémoire tampon doit rester valide jusqu’à ce que la fonction d’achèvement de l’injection soit appelée.

remoteScopeId

Structure SCOPE_ID qui contient l’identificateur d’étendue de l’adresse IP distante. L’identificateur d’étendue est fourni à une légende par le biais du membre remoteScopeId du FWPS_INCOMING_METADATA_VALUES0 structure passée à la fonction de légende classifyFn du pilote de légende. La structure SCOPE_ID est définie dans Ws2ipdef.h comme suit.

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

controlData

Pointeur facultatif vers une mémoire tampon qui contient des données de contrôle de socket spécifiées par la fonction WSASendMsg . Pour plus d’informations sur le type WSACMSGHDR , consultez CMSGHDR.

Le cas échéant, les données de contrôle de socket sont fournies à une légende avec le membre controlData du FWPS_INCOMING_METADATA_VALUES0 structure passée à la fonction de légende classifyFn du pilote de légende.

Si les données de contrôle de socket n’ont pas la valeur NULL, elles doivent être copiées en profondeur dans l’implémentation du pilote de légende de la fonction classifyFn , et la mémoire tampon controlData doit être conservée valide jusqu’à ce que la fonction d’achèvement de l’injection soit appelée.

controlDataLength

Longueur, en octets, du membre controlData .