FWPS_NET_BUFFER_LIST_NOTIFY_FN1 fonction de rappel (fwpsk.h)

Article
02/29/2024

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

Notez FWPS_NET_BUFFER_LIST_NOTIFY_FN1 est la version spécifique de FWPS_NET_BUFFER_LIST_NOTIFY_FN utilisée dans Windows 8 et versions ultérieures. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows . Pour Windows 7, FWPS_NET_BUFFER_LIST_NOTIFY_FN0 est disponible.

Syntaxe

FWPS_NET_BUFFER_LIST_NOTIFY_FN1 FwpsNetBufferListNotifyFn1;

NTSTATUS FwpsNetBufferListNotifyFn1(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out]           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] netBufferList

Pointeur vers la liste de mémoires tampons qui contient des paquets précédemment étiqueté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 d’intérêt. 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 d’intérêt au contexte du pilote de légende.

Valeur retournée

Une légende FWPS_NET_BUFFER_LIST_NOTIFY_FN1 fonction retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	Le pilote de légende accepte la notification du moteur de filtre.
Autres codes status	Une erreur est survenue.

Remarques

Cette fonction est associée à un pilote de légende par un appel à FwpsNetBufferListAssociateContext1. 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.

Cette fonction est identique à FWPS_NET_BUFFER_LIST_NOTIFY_FN0, sauf que le type de retour est NTSTATUS au lieu de VOID.

Configuration requise

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

Voir aussi

Fonctions de légende du pilote de légende

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

Utilisation de l’étiquetage de paquets

Partager via