Funzione FwpsNetBufferListRemoveContext0 (fwpsk.h)

Articolo
02/07/2025

La funzione FwpsNetBufferListRemoveContext0 rimuove il contesto associato a un elenco di buffer di rete.

NotaFwpsNetBufferListRemoveContext0 è una versione specifica di FwpsNetBufferListRemoveContext. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Sintassi

NTSTATUS FwpsNetBufferListRemoveContext0(
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in]                UINT64          contextTag,
  [in]                UINT32          flags
);

Parametri

[in, out, optional] netBufferList

Elenco di buffer di rete che indica uno o più pacchetti di interesse per il driver di callout. Questo parametro è facoltativo e può essere NULL. Se è NULL, la funzione rimuoverà il contesto da tutti gli elenchi di buffer di rete associati.

[in] contextTag

Tag di contesto passato nel parametro contextTag a FwpsNetBufferListAssociateContext0.

[in] flags

Questo parametro è riservato per uso futuro e deve essere zero.

Valore restituito

La funzione fwpsNetBufferListRemoveContext0 restituisce uno dei codici di NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il contesto è stato rimosso correttamente.
Altri codici di stato	Si è verificato un errore.

Osservazioni

La funzione FwpsNetBufferListRemoveContext0 rimuove in modo asincrono il contesto contrassegnato associato a un elenco di buffer di rete.

Per associare un contesto a un elenco di buffer di rete, chiamare FwpsNetBufferListAssociateContext0 o FwpsNetBufferListAssociateContext1.

In genere un driver callout non dovrà usare questa funzione, perché il contesto con tag viene rimosso automaticamente quando i pacchetti si spostano nello stack. Questa funzione viene fornita in modo che un driver callout possa interrompere l'elaborazione in situazioni in cui i contesti non vengono rimossi automaticamente. Ad esempio, nel caso di un driver di filtro NDIS, i pacchetti non immettono mai lo stack TCP/IP e i contesti devono essere rimossi manualmente chiamando FwpsNetBufferListRemoveContext0 con il parametro netBufferList impostato su NULL.

Fabbisogno

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

Vedere anche

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

uso dell'assegnazione di tag ai pacchetti

Condividi tramite