FwpsCloneStreamData0, fonction (fwpsk.h)
La fonction FwpsCloneStreamData0 alloue un clone d’un flux de données FWPS_STREAM_DATA0 existant.
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 |
|---|---|
|
La structure de FWPS_STREAM_DATA0 clone a été correctement allouée. |
|
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 |