FWPS_NET_BUFFER_LIST_NOTIFY_FN1 fonction de rappel (fwpsk.h)

Article
02/07/2025

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 marqués par la légende.

Remarque 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, consultez 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 du énumération FWPS_NET_BUFFER_LIST_EVENT_TYPE0.

[in, out] netBufferList

Pointeur vers la liste de 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 d’intérêt. Cette valeur est la valeur affectée au paquet par le pilote de légende et 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 de retour

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

Retourner le code	Description
STATUS_SUCCESS	Le pilote de légende accepte la notification du moteur de filtre.
Autres codes d’état	Une erreur s’est produite.

Remarques

Cette fonction est associée à un pilote de légende par un appel à FwpsNetBufferListAssociateContext1. Un pilote de légende peut utiliser une fonction de notification unique pour gérer les messages pour plusieurs listes de mémoires tampons associées à l’aide de la balise de contexte et du 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.