Compartilhar via


Função FwpsReferenceNetBufferList0 (fwpsk.h)

A função FwpsReferenceNetBufferList0 incrementa a contagem de referência para uma estrutura de NET_BUFFER_LIST .

ObservaçãoFwpsReferenceNetBufferList0 é uma versão específica de FwpsReferenceNetBufferList. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.
 

Sintaxe

void FwpsReferenceNetBufferList0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      BOOLEAN         intendToModify
);

Parâmetros

[in, out] netBufferList

Um ponteiro para a estrutura NET_BUFFER_LIST para a qual a contagem de referência está sendo incrementada.

[in] intendToModify

Um valor que indica se um texto explicativo pretende modificar a lista de buffers de rede clonada, cujo pai é apontado pelo parâmetro netBufferList , após o retorno da função classifyFn . Se TRUE, o texto explicativo pretende modificar a lista de buffers de rede clonado depois que classifyFn retornar (uma modificação fora de banda). Caso contrário, defina como FALSE.

Retornar valor

Nenhum

Comentários

Um driver de texto explicativo chama a função FwpsReferenceNetBufferList0 para incrementar a contagem de referência para uma estrutura de NET_BUFFER_LIST de modo que a lista de buffers de rede permaneça válida fora da função classifyFn .

Por exemplo, quando um driver de texto explicativo executa a remontagem de pacotes, ele incrementa a contagem de referência para cada uma das estruturas de NET_BUFFER_LIST recebidas que descrevem os fragmentos de pacote que compõem um pacote individual. Isso permite que a nova estrutura de NET_BUFFER_LIST que descreve o pacote remontado referencie com segurança as MDLs (listas de descritores de memória) apontadas pelas estruturas de NET_BUFFER_LIST que descrevem os fragmentos de pacote. Depois que o driver de texto explicativo injetou a nova estrutura NET_BUFFER_LIST na pilha de rede, ele diminui a contagem de referência para cada uma das estruturas de NET_BUFFER_LIST que descrevem os fragmentos de pacote de sua rotina de conclusão de injeção de pacote.

Um driver de texto explicativo deve chamar a função FwpsDereferenceNetBufferList0 para a estrutura NET_BUFFER_LIST depois que o driver de texto explicativo terminar de referenciar a estrutura.

Diretrizes para gerenciar pacotes referenciados

Um driver de texto explicativo não deve conter pacotes referenciados indefinidamente. Um pacote referenciado pode interferir nas operações de gerenciamento de energia em um computador ocioso.

O uso pretendido para pacotes referenciados no WFP é obter esclarecimentos de um aplicativo no modo de usuário ou de outra operação relativamente rápida. O driver de texto explicativo não deve conter pacotes referenciados enquanto, por exemplo, aguardar a entrada do usuário, a liberação do serviço Web ou qualquer outra operação que possa levar um tempo arbitrário.

Se o driver de texto explicativo precisar aguardar uma operação potencialmente longa, ele deverá fazer uma cópia profunda do pacote usando FwpsAllocateNetBufferAndNetBufferList0 e bloquear e absorver o pacote original.

Os drivers de texto explicativo sempre devem retornar pacotes mantidos o mais rápido possível.

Requisitos

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

Confira também

FwpsDereferenceNetBufferList0

NET_BUFFER_LIST

classifyFn