FWPS_NET_BUFFER_LIST_NOTIFY_FN0 funzione di callback (fwpsk.h)

Articolo
03/05/2024

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 Versioni specifiche di Windows . Per Windows 8 è disponibile FWPS_NET_BUFFER_LIST_NOTIFY_FN1.

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 dell'oggetto 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 di callout.

[in, out, optional] newNetBufferList

Puntatore a un elenco di buffer aggiornato che contiene pacchetti interessanti per il driver di 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 questo parametro.

[in] layerId

Livello da cui è stata chiamata la funzione di notifica.

[in] context

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

[in] contextTag

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

Valore restituito

nessuno

Osservazioni

Questa funzione è associata a un driver di callout tramite una chiamata a FwpsNetBufferListAssociateContext0. Un driver di 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 tra le istanze.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 7.
Piattaforma di destinazione	Windows
Intestazione	fwpsk.h (includere Fwpsk.h)
IRQL	<= DISPATCH_LEVEL