FWPS_INJECT_COMPLETE0 fonction de rappel (fwpsk.h)

Article
08/07/2023

Le moteur de filtre appelle la fonction de légende completionFn d’une légende chaque fois que des données de paquet, décrites par le paramètre netBufferList dans l’une des fonctions d’injection de paquets, ont été injectées dans la pile réseau.

Syntaxe

FWPS_INJECT_COMPLETE0 FwpsInjectComplete0;

void FwpsInjectComplete0(
  [in]      void *context,
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      BOOLEAN dispatchLevel
)
{...}

Paramètres

[in] context

Pointeur vers le paramètre completionContext de l’une des fonctions d’injection de paquets appelées par le pilote de légende.

[in, out] netBufferList

Pointeur transmis dans le paramètre netBufferList de l’une des fonctions d’injection de paquets appelées par le pilote de légende.

[in] dispatchLevel

Valeur qui indique l’IRQL auquel la fonction de légende completionFn est appelée. Si ce paramètre a la valeur TRUE, la fonction de légende completionFn est appelée à IRQL = DISPATCH_LEVEL. Si ce paramètre a la valeur FALSE, la fonction de légende completionFn est appelée à un DISPATCH_LEVEL IRQL < .

Valeur de retour

None

Remarques

Le type FWPS_INJECT_COMPLETE0 est défini comme pointeur vers la fonction completionFn comme suit :

typedef void (NTAPI *FWPS_INJECT_COMPLETE0) completionFn

Le membre Status de la structure NET_BUFFER_LIST pointée par NetBufferList indique le résultat de l’opération d’injection.

Une fois que les données de paquet dans une chaîne de structure clonée ou créée NET_BUFFER_LIST ont été injectées dans la pile réseau par l’une des fonctions d’injection de paquets, completionFn est appelé.

Si la fonction FwpsStreamInjectAsync0 est appelée pour injecter une chaîne de structures NET_BUFFER_LIST , completionFn est appelée une fois pour chaque NET_BUFFER_LIST de la chaîne, à chaque fois à l’aide du même paramètre completionContext spécifié dans FwpsStreamInjectAsync0. Dans ce cas, l’implémentation completionFn du pilote de légende doit appeler FwpsFreeCloneNetBufferList0 pour libérer le NET_BUFFER_LIST actuellement indiqué.

Le moteur de filtre appelle la fonction de légende completionFn d’une légende à IRQL <= DISPATCH_LEVEL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows Vista.
Plateforme cible	Windows
En-tête	fwpsk.h (inclure Fwpsk.h)
IRQL	<= DISPATCH_LEVEL