FWPS_INJECT_COMPLETE0 função de retorno de chamada (fwpsk.h)

Artigo
02/26/2024

O mecanismo de filtro chama a função de texto explicativo completionFn de um texto explicativo sempre que os dados de pacote, descritos pelo parâmetro netBufferList em uma das funções de injeção de pacote, são injetados na pilha de rede.

Sintaxe

FWPS_INJECT_COMPLETE0 FwpsInjectComplete0;

void FwpsInjectComplete0(
  [in]      void *context,
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      BOOLEAN dispatchLevel
)
{...}

Parâmetros

[in] context

Um ponteiro para o parâmetro completionContext de uma das funções de injeção de pacote chamada pelo driver de texto explicativo.

[in, out] netBufferList

O ponteiro passado no parâmetro netBufferList de uma das funções de injeção de pacote chamada pelo driver de texto explicativo.

[in] dispatchLevel

Um valor que indica o IRQL no qual a função de texto explicativo completionFn está sendo chamada. Se esse parâmetro for TRUE, a função de texto explicativo completionFn será chamada em IRQL = DISPATCH_LEVEL. Se esse parâmetro for FALSE, a função de texto explicativo completionFn será chamada em um DISPATCH_LEVEL IRQL < .

Retornar valor

Nenhum

Comentários

O tipo FWPS_INJECT_COMPLETE0 é definido como um ponteiro para a função completionFn da seguinte maneira:

typedef void (NTAPI *FWPS_INJECT_COMPLETE0) completionFn

O membro Status da estrutura NET_BUFFER_LIST apontada por NetBufferList indica o resultado da operação de injeção.

Depois que os dados de pacote em uma cadeia de estrutura NET_BUFFER_LIST clonada ou criada tiverem sido injetados com êxito na pilha de rede por uma das funções de injeção de pacote,completionFn será chamado.

Se a função FwpsStreamInjectAsync0 for chamada para injetar uma cadeia de estruturas NET_BUFFER_LIST , completionFn será chamado uma vez para cada NET_BUFFER_LIST na cadeia, cada vez usando o mesmo parâmetro completionContext especificado em FwpsStreamInjectAsync0. Nesse caso, a implementação de completionFn do driver de texto explicativo deve chamar FwpsFreeCloneNetBufferList0 para liberar o NET_BUFFER_LIST indicado no momento.

O mecanismo de filtro chama a função de texto explicativo completionFn de um texto explicativo em IRQL <= DISPATCH_LEVEL.

Requisitos

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