funzione di callback FWPS_NET_BUFFER_LIST_NOTIFY_FN1 (fwpsk.h)

Articolo
02/29/2024

Il motore di filtro chiama la funzione callout FWPS_NET_BUFFER_LIST_NOTIFY_FN1 per notificare al driver di 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 Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information. 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 del callout.

[in, out, optional] newNetBufferList

Puntatore a un elenco di buffer aggiornato che contiene pacchetti interessanti per il driver del 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 del callout e viene usato per identificare il pacchetto.

[in] contextTag

Tag di contesto utilizzato per associare i pacchetti di interesse al contesto del driver del 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 del callout accetta la notifica dal motore di filtro.
Altri codici di stato	Si è verificato un errore.

Commenti

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

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

Requisiti

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

Vedi anche

Funzioni callout driver callout

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

Uso dell'assegnazione di tag ai pacchetti

Condividi tramite