Funzione FwpsNetBufferListAssociateContext1 (fwpsk.h)

Articolo
02/07/2025

La funzione FwpsNetBufferListAssociateContext1 associa il contesto del driver di callout a un elenco di buffer di rete e configura la notifica per gli eventi dell'elenco di buffer di rete.

NotaFwpsNetBufferListAssociateContext1 è la versione specifica di FwpsNetBufferListAssociateContext 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 è disponibile FwpsNetBufferListAssociateContext0.

Sintassi

NTSTATUS FwpsNetBufferListAssociateContext1(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
  [in]      UINT32                          flags
);

Parametri

[in, out] netBufferList

Elenco di buffer di rete che indica uno o più pacchetti di interesse per il driver di callout.

[in] layerId

Identificatore del livello in cui è associato il contesto. Quando si chiama questa funzione dal percorso di ricezione NDIS, impostare questo parametro su FWPS_LAYER_NON_WFP.

[in] context

Informazioni sul contesto arbitrarie impostate dal driver callout. Il motore di filtro passerà questo contesto al driver del callout
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 funzione.

[in] contextTag

Identificatore univoco locale ottenuto chiamando funzione di FwpsNetBufferListGetTagForContext0.

providerGuid

GUID del provider.

[in, out] deviceObject

Puntatore all'oggetto dispositivo del driver del callout.

[in] notifyFn

Puntatore alla funzione di FWPS_NET_BUFFER_LIST_NOTIFY_FN1 del driver del callout. Il motore di filtro invierà notifiche di stato a questa funzione.

[in] flags

Questo parametro è riservato per uso futuro ed è impostato su zero.

Valore restituito

La funzione FwpsNetBufferListAssociateContext1 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	L'associazione ha avuto esito positivo.
Altri codici di stato	Si è verificato un errore.

Osservazioni

La funzione FwpsNetBufferListAssociateContext1 associa gruppi di pacchetti al driver callout. I pacchetti di interesse possono essere monitorati per l'ispezione tramite più livelli nello stack.

Prima di chiamare questa funzione, è necessario chiamare la funzione FwpsNetBufferListGetTagForContext0 per ottenere un tag di contesto.

Questa funzione è essenzialmente identica alla versione precedente,

FwpsNetBufferListAssociateContext0. L'unica differenza è la funzione FWPS_NET_BUFFER_LIST_NOTIFY_FN1 aggiornata a cui punta il parametro notifyFn .

Fabbisogno

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

Vedere anche

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

uso dell'assegnazione di tag ai pacchetti

Condividi tramite