FWPS_NET_BUFFER_LIST_NOTIFY_FN1 funzione di callback (fwpsk.h)

Articolo
02/06/2025

Il motore di filtro chiama la funzione callout FWPS_NET_BUFFER_LIST_NOTIFY_FN1 per notificare al driver callout gli eventi associati ai pacchetti contrassegnati dal callout.

Nota FWPS_NET_BUFFER_LIST_NOTIFY_FN1 è la versione specifica di FWPS_NET_BUFFER_LIST_NOTIFY_FN usata in Windows 8 e versioni successive. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows. Per Windows 7, FWPS_NET_BUFFER_LIST_NOTIFY_FN0 è disponibile.

Sintassi

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
)
{...}

Parametri

[in] eventType

Valore che indica il tipo di notifica che il motore di filtro invia al callout. Questo parametro verrà impostato su uno dei valori di FWPS_NET_BUFFER_LIST_EVENT_TYPE0'enumerazione .

[in, out] netBufferList

Puntatore all'elenco di buffer che contiene pacchetti contrassegnati in precedenza come interessanti dal driver callout.

[in, out, optional] newNetBufferList

Puntatore a un elenco di buffer aggiornato che contiene pacchetti interessanti per il driver callout. L'uso di questo parametro varia a seconda del tipo di evento. Per gli eventi in cui viene apportata una modifica al pacchetto indicato, la versione modificata viene passata come parametro.

[in] layerId

Livello da cui è stata chiamata la funzione di notifica.

[in] context

Contesto utilizzato per contrassegnare i pacchetti di interesse. Questo valore è il valore assegnato al pacchetto dal driver callout e viene usato per identificare il pacchetto.

[in] contextTag

Tag di contesto utilizzato per associare i pacchetti di interesse al contesto del driver di callout.

Valore restituito

Un callout FWPS_NET_BUFFER_LIST_NOTIFY_FN1 funzione restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il driver callout accetta la notifica dal motore di filtro.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Questa funzione è associata a un driver callout da una chiamata a FwpsNetBufferListAssociateContext1. Un driver callout può usare una singola funzione di notifica per gestire i messaggi per più elenchi di buffer associati usando il contesto e il tag di contesto per distinguere le istanze.

Questa funzione è identica a FWPS_NET_BUFFER_LIST_NOTIFY_FN0, ad eccezione del fatto che il tipo restituito è NTSTATUS anziché VOID.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Finestre
intestazione	fwpsk.h (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL

Vedere anche

funzioni callout del driver callout

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

uso dell'assegnazione di tag ai pacchetti

Condividi tramite