FWPS_INJECT_COMPLETE0 fonction de rappel (fwpsk.h)
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 |