Partager via


structure FWPS_TRANSPORT_SEND_PARAMS1 (fwpsk.h)

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

remarqueFWPS_TRANSPORT_SEND_PARAMS1 est la version spécifique de FWPS_TRANSPORT_SEND_PARAMS utilisée dans Windows 7 et versions ultérieures. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows. Pour Windows Vista, FWPS_TRANSPORT_SEND_PARAMS0 est disponible.
 

Syntaxe

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

Membres

remoteAddress

Pointeur vers une mémoire tampon qui spécifie l’adresse IP distante à laquelle le socket doit être envoyé. L’adresse distante spécifiée par ce membre peut être différente de celle passée en tant qu’une des valeurs de données entrantes au classifieFn fonction de légende 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 du réseau. La version IP doit correspondre au paramètre AddressFamily spécifié dans le fonction FwpsInjectTransportSendAsync1.

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 via le remoteScopeId membre du FWPS_INCOMING_METADATA_VALUES0 structure passée à la fonction de légende classifierFn fonction de légende 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 les données de contrôle de socket spécifiées par la fonction WSASendMsg. Pour plus d’informations sur le type de WSACMSGHDR, consultez CMSGHDR.

Si elles sont présentes, les données de contrôle de socket sont fournies à une légende avec le controlData membre du FWPS_INCOMING_METADATA_VALUES0 structure passée à la fonction de légende classifierFn fonction de légende du pilote de légende.

Si les données de contrôle de socket ne sont pas null, elles doivent être copiées en profondeur dans l’implémentation du pilote de légende de la fonction classifierFn, 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.

headerIncludeHeader

En-tête de transport à inclure.

headerIncludeHeaderLength

Longueur, en octets, du membre headerIncludeHeader.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows 7.
d’en-tête fwpsk.h (include Fwpsk.h)

Voir aussi

CMSGHDR

FWPS_INCOMING_METADATA_VALUES0 FwpsInjectTransportSendAsync1

WSASendMsg

classifierFn