Funzione FwpsNetBufferListAssociateContext1 (fwpsk.h)

Articolo
03/08/2023

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 utilizzata in Windows 8 e versioni successive. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows . Per Windows 7, FwpsNetBufferListAssociateContext0 è disponibile.

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 di callout. Il motore di filtro passerà questo contesto al callout del driver
funzione FWPS_NET_BUFFER_LIST_NOTIFY_FN1 .

[in] contextTag

Identificatore univoco locale ottenuto chiamando Funzione FwpsNetBufferListGetTagForContext0 .

providerGuid

GUID del provider.

[in, out] deviceObject

Puntatore all'oggetto dispositivo del driver di 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 l'uso futuro e è impostato su zero.

Valore restituito

La funzione FwpsNetBufferListAssociateContext1 restituisce uno dei codici NTSTATUS seguenti.

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

Commenti

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

Prima di chiamare questa funzione, la funzione FwpsNetBufferListGetTagForContext0 deve essere chiamata 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 .

Requisiti

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

Vedi anche

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Uso dell'assegnazione di tag ai pacchetti

Condividi tramite