Funzione FwpsNetBufferListAssociateContext0 (fwpsk.h)

Articolo
02/29/2024

La funzione FwpsNetBufferListAssociateContext0 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.

NotaFwpsNetBufferListAssociateContext0 è la versione specifica di FwpsNetBufferListAssociateContext usata in Windows 7 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 8, è disponibile FwpsNetBufferListAssociateContext1.

Sintassi

NTSTATUS FwpsNetBufferListAssociateContext0(
  [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_FN0 notifyFn,
  [in]      UINT32                          flags
);

Parametri

[in, out] netBufferList

Elenco di buffer di rete che indica uno o più pacchetti di interesse per il driver del 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 del callout. Il motore di filtro passerà questo contesto al driver del callout FWPS_NET_BUFFER_LIST_NOTIFY_FN0.

[in] contextTag

Identificatore univoco locale ottenuto chiamando Funzione FwpsNetBufferListGetTagForContext0 .

providerGuid

GUID del provider.

[in, out] deviceObject

Puntatore all'oggetto dispositivo del driver del callout.

[in] notifyFn

Puntatore al conducente del callout FWPS_NET_BUFFER_LIST_NOTIFY_FN0 funzione. 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 FwpsNetBufferListAssociateContext0 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.

Commenti

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

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

Requisiti

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

Vedi anche

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Uso dell'assegnazione di tag ai pacchetti

Condividi tramite