FWPS_INJECT_COMPLETE0 fonction de rappel (fwpsk.h)

Le moteur de filtre appelle la fonction de légende d’achèvementFn d’un légende chaque fois que les données de paquets, 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 passé 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 à laquelle la fonction de légende completionFn est appelée. Si ce paramètre est TRUE, la fonction de légende completionFn est appelée à IRQL = DISPATCH_LEVEL. Si ce paramètre est 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 paquets 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, l’achèvementFn est appelé.

Si la fonction FwpsStreamInjectAsync0 est appelée pour injecter une chaîne de structures NET_BUFFER_LIST , completionFn est appelé une fois pour chaque NET_BUFFER_LIST dans la chaîne, chaque fois à l’aide du même paramètre completionContext spécifié dans FwpsStreamInjectAsync0. Dans ce cas, l’implémentation de fin 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 d’achèvementFn d’un légende à IRQL <= DISPATCH_LEVEL.

Configuration requise

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

Voir aussi

Fonctions de légende du pilote

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFreeCloneNetBufferList0

FwpsInjectionHandleCreate0

FwpsInjectionHandleDestroy0

FwpsStreamInjectAsync0

NET_BUFFER_LIST

Fonctions d’injection de paquets