Função FwpsNetBufferListRemoveContext0 (fwpsk.h)

  • Artigo

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

ObservaçãoFwpsNetBufferListRemoveContext0 é uma versão específica de FwpsNetBufferListRemoveContext. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas 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.

Retornar valor

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

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

Comentários

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 de texto 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 entram na pilha TCP/IP e os contextos precisarão ser removidos manualmente chamando FwpsNetBufferListRemoveContext0 com o parâmetro netBufferList definido como NULL.

Requisitos

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

Confira também

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Usando marcação de pacote