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.
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) |