FWPS_NET_BUFFER_LIST_NOTIFY_FN0 fonction de rappel (fwpsk.h)

Article
02/27/2024

Le moteur de filtre appelle la fonction de légende FWPS_NET_BUFFER_LIST_NOTIFY_FN0 pour informer le pilote de légende des événements associés aux paquets marqués par la légende.

NotezFWPS_NET_BUFFER_LIST_NOTIFY_FN0 est la version spécifique de FWPS_NET_BUFFER_LIST_NOTIFY_FN utilisée dans Windows 7 et versions ultérieures. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows . Pour Windows 8, FWPS_NET_BUFFER_LIST_NOTIFY_FN1 est disponible.

Syntaxe

FWPS_NET_BUFFER_LIST_NOTIFY_FN0 FwpsNetBufferListNotifyFn0;

void FwpsNetBufferListNotifyFn0(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

Paramètres

[in] eventType

Valeur qui indique le type de notification que le moteur de filtre envoie à la légende. Ce paramètre est défini sur l’une des valeurs de FWPS_NET_BUFFER_LIST_EVENT_TYPE0 énumération.

[in, out, optional] netBufferList

Pointeur vers la liste des mémoires tampons qui contient des paquets précédemment marqués comme intéressants par le pilote de légende.

[in, out, optional] newNetBufferList

Pointeur vers une liste de mémoires tampons mise à jour qui contient des paquets intéressants pour le pilote de légende. L’utilisation de ce paramètre diffère selon le type d’événement. Pour les événements où une modification est apportée au paquet indiqué, la version modifiée est passée en tant que paramètre .

[in] layerId

Couche à partir de laquelle la fonction de notification a été appelée.

[in] context

Contexte utilisé pour baliser les paquets intéressants. Cette valeur est la valeur affectée au paquet par le pilote de légende et est utilisée pour identifier le paquet.

[in] contextTag

Balise de contexte utilisée pour associer les paquets intéressants au contexte du pilote de légende.

Valeur de retour

None

Remarques

Cette fonction est associée à un pilote de légende par un appel à FwpsNetBufferListAssociateContext0. Un pilote de légende peut utiliser une seule fonction de notification pour gérer les messages de plusieurs listes de mémoires tampons associées en utilisant le contexte et la balise de contexte pour différencier les instances.

Configuration requise

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