FWPS_NET_BUFFER_LIST_NOTIFY_FN0 funzione di callback (fwpsk.h)

Articolo
02/07/2025

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

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

Sintassi

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

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, optional] 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

Nessuno

Osservazioni

Questa funzione è associata a un driver callout da una chiamata a FwpsNetBufferListAssociateContext0. 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.

Fabbisogno

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