structure FWPS_STREAM_DATA0 (fwpsk.h)

Article
02/07/2025

La structure FWPS_STREAM_DATA0 décrit une partie d’un flux de données.

RemarqueFWPS_STREAM_DATA0 est une version spécifique de FWPS_STREAM_DATA. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Syntaxe

typedef struct FWPS_STREAM_DATA0_ {
  UINT32                   flags;
  FWPS_STREAM_DATA_OFFSET0 dataOffset;
  SIZE_T                   dataLength;
  NET_BUFFER_LIST          *netBufferListChain;
} FWPS_STREAM_DATA0;

Membres

flags

Variable contenant des indicateurs qui spécifient les caractéristiques du flux de données.

Pour les flux de données entrants, il peut s’agir d’un ou plusieurs des indicateurs suivants :

FWPS_STREAM_FLAG_RECEIVE

Spécifie que le flux est un flux de données entrant. Cet indicateur est toujours défini pour les flux de données entrants.

FWPS_STREAM_FLAG_RECEIVE_EXPEDITED

Spécifie que le flux de données entrant contient des données hors bande de haute priorité.

FWPS_STREAM_FLAG_RECEIVE_DISCONNECT

Spécifie que les données entrantes sont arrivées avec l’indicateur FIN défini dans l’en-tête TCP. Cela indique que l’expéditeur a déconnecté le flux.

FWPS_STREAM_FLAG_RECEIVE_ABORT

Spécifie que les données entrantes sont arrivées avec l’indicateur RST défini dans l’en-tête TCP. Cela indique que l’expéditeur a réinitialisé le flux.

Remarque Cet indicateur n’est pas implémenté dans Windows Vista.

Pour les flux de données sortants, il peut s’agir d’un ou plusieurs des indicateurs suivants :

FWPS_STREAM_FLAG_SEND

Spécifie que le flux est un flux de données sortant. Cet indicateur est toujours défini pour les flux de données sortants.

FWPS_STREAM_FLAG_SEND_EXPEDITED

Spécifie que le flux de données sortants contient des données hors bande de haute priorité.

FWPS_STREAM_FLAG_SEND_NODELAY

Spécifie que le client d’envoi demande que le flux de données sortant ne doit pas être mis en mémoire tampon. Si cet indicateur est défini, un pilote de légende ne doit pas tenir sur la mémoire tampon de flux plus longtemps que nécessaire.

FWPS_STREAM_FLAG_SEND_DISCONNECT

Spécifie que le flux doit être déconnecté après l’envoi des données dans le flux de données sortants. La pile réseau définit l’indicateur FIN dans l’en-tête TCP du dernier paquet envoyé.

FWPS_STREAM_FLAG_SEND_ABORT

Spécifie que le flux doit être réinitialisé une fois les données du flux de données sortantes envoyées. La pile réseau définit l’indicateur RST dans l’en-tête TCP du dernier paquet envoyé. Les pilotes de légende ne doivent pas appeler la fonction FwpsStreamInjectAsync0 pour injecter des données dans le flux si cet indicateur est défini.

Remarque Cet indicateur n’est pas implémenté dans Windows Vista.

dataOffset

Structure FWPS_STREAM_DATA_OFFSET0 qui spécifie le décalage dans le flux de données où commence la partie du flux de données.

dataLength

Nombre d’octets dans la partie du flux de données.

netBufferListChain

Pointeur vers une structure NET_BUFFER_LIST qui décrit la partie du flux de données.

Remarques

Le moteur de filtre utilise la structure FWPS_STREAM_DATA0 pour décrire la partie d’un flux de données que la fonction de légende classifieFn fonction de légende peut traiter. Le dataStream membre du FWPS_STREAM_CALLOUT_IO_PACKET0 structure pointe vers une structure FWPS_STREAM_DATA0.