Função FwpsNetBufferListRemoveContext0 (fwpsk.h)

Artigo
02/07/2025

A função FwpsNetBufferListRemoveContext0 remove o contexto associado a uma lista de buffers de rede.

Observação FwpsNetBufferListRemoveContext0 é uma versão específica do FwpsNetBufferListRemoveContext. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Sintaxe

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

Parâmetros

[in, out, optional] netBufferList

Uma lista de buffers de rede que indica um ou mais pacotes de interesse para o driver de texto explicativo. Esse parâmetro é opcional e pode ser NULL. Se for NULL, a função removerá o contexto de todas as listas de buffer de rede associadas.

[in] contextTag

A marca de contexto que foi passada no parâmetro contextTag para FwpsNetBufferListAssociateContext0.

[in] flags

Esse parâmetro é reservado para uso futuro e deve ser zero.

Valor de retorno

A função FwpsNetBufferListRemoveContext0 retorna um dos seguintes códigos de NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	O contexto foi removido com êxito.
Outros códigos de status	Ocorreu um erro.

Observações

A função FwpsNetBufferListRemoveContext0 remove de forma assíncrona o contexto marcado associado a uma lista de buffers de rede.

Para associar um contexto a uma lista de buffers de rede, chame FwpsNetBufferListAssociateContext0 ou FwpsNetBufferListAssociateContext1.

Normalmente, um driver explicativo não precisará usar essa função, pois o contexto marcado é removido automaticamente quando os pacotes se movem pela pilha. Essa função é fornecida para que um driver de texto explicativo possa parar o processamento em situações em que os contextos não são removidos automaticamente. Por exemplo, no caso de um driver de filtro NDIS, os pacotes nunca inserem a pilha TCP/IP e os contextos precisarão ser removidos manualmente chamando FwpsNetBufferListRemoveContext0 com o parâmetro netBufferList definido como NULL.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 7.
da Plataforma de Destino	Universal
cabeçalho	fwpsk.h (inclua Fwpsk.h)
biblioteca	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Consulte também

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

usando de marcação de pacote

Compartilhar via