FwpsCloneStreamData0, fonction (fwpsk.h)

Article
08/07/2023

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