Partager via


FwpsCloneStreamData0, fonction (fwpsk.h)

La fonction FwpsCloneStreamData0 alloue un clone d’un flux de données FWPS_STREAM_DATA0 existant.

RemarqueFwpsCloneStreamData0 est une version spécifique de FwpsCloneStreamData. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .
 

Syntaxe

NTSTATUS FwpsCloneStreamData0(
  [in, out]      FWPS_STREAM_DATA0 *calloutStreamData,
  [in, optional] NDIS_HANDLE       netBufferListPoolHandle,
  [in, optional] NDIS_HANDLE       netBufferPoolHandle,
  [in]           ULONG             allocateCloneFlags,
  [out]          NET_BUFFER_LIST   **netBufferListChain
);

Paramètres

[in, out] calloutStreamData

Pointeur vers la structure FWPS_STREAM_DATA0 d’origine qui doit avoir sa structure NET_BUFFER_LIST cloné.

[in, optional] netBufferListPoolHandle

Un NET_BUFFER_LIST handle de pool obtenu à partir d’un appel précédent à la fonction NdisAllocateNetBufferListPool . Ce paramètre est facultatif et peut être NULL.

[in, optional] netBufferPoolHandle

Un handle de pool NET_BUFFER obtenu à partir d’un appel précédent à Fonction NdisAllocateNetBufferPool . Ce paramètre est facultatif et peut être NULL.

[in] allocateCloneFlags

Aucun indicateur n’est actuellement défini pour cette fonction. Les pilotes de légende doivent définir ce paramètre sur zéro.

[out] netBufferListChain

Pointeur vers un emplacement qui reçoit un pointeur vers une chaîne de structures NET_BUFFER_LIST qui décrivent toutes les données de flux clonées.

Valeur retournée

La fonction FwpsCloneStreamData0 retourne l’un des codes NTSTATUS suivants.

Code de retour Description
STATUS_SUCCESS
La structure de FWPS_STREAM_DATA0 clone a été correctement allouée.
Autres codes status
Une erreur est survenue.

Remarques

Ces données de flux clonées peuvent être injectées ultérieurement par un pilote de légende dans la pile réseau TCP/IP.

La fonction FwpsCloneStreamData0 clone la chaîne entière des structures NET_BUFFER_LIST contenues dans le flux de données FWPS_STREAM_DATA0 existant. La fonction supprime les données inutilisées de sorte qu’un pilote de légende puisse passer correctement la chaîne cloné à la Fonction FwpsStreamInjectAsync0 .

Une fois que les données de flux dans le clone NET_BUFFER_LIST chaîne de structure ont été correctement injectées dans la pile réseau, la fonction de légende completionFn est appelée pour chaque structure de clone NET_BUFFER_LIST, et une légende doit appeler FwpsFreeCloneNetBufferList0 pour libérer la structure de clone NET_BUFFER_LIST.

Une légende doit appeler la fonction FwpsDiscardClonedStreamData0 si les données de flux clonées doivent être ignorées sans être réinjectées.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows Vista.
Plateforme cible Universal
En-tête fwpsk.h (include Fwpsk.h)
Bibliothèque Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

Voir aussi

FWPS_STREAM_DATA0

FwpsDiscardClonedStreamData0

FwpsFreeCloneNetBufferList0

FwpsStreamInjectAsync0

NET_BUFFER

NET_BUFFER_LIST