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

Artigo
02/07/2025

O mecanismo de filtro chama a função de texto explicativo FWPS_NET_BUFFER_LIST_NOTIFY_FN0 para notificar o driver explicativo sobre eventos associados a pacotes marcados pelo texto explicativo.

ObservaçãoFWPS_NET_BUFFER_LIST_NOTIFY_FN0 é a versão específica de FWPS_NET_BUFFER_LIST_NOTIFY_FN usada no Windows 7 e posterior. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações. Para o Windows 8, FWPS_NET_BUFFER_LIST_NOTIFY_FN1 está disponível.

Sintaxe

FWPS_NET_BUFFER_LIST_NOTIFY_FN0 FwpsNetBufferListNotifyFn0;

void FwpsNetBufferListNotifyFn0(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

Parâmetros

[in] eventType

Um valor que indica o tipo de notificação que o mecanismo de filtro está enviando para o texto explicativo. Esse parâmetro será definido como um dos valores do FWPS_NET_BUFFER_LIST_EVENT_TYPE0 enumeração.

[in, out, optional] netBufferList

Um ponteiro para a lista de buffers que contém pacotes que foram marcados anteriormente como interessantes pelo driver de texto explicativo.

[in, out, optional] newNetBufferList

Um ponteiro para uma lista de buffers atualizada que contém pacotes interessantes para o driver de texto explicativo. O uso desse parâmetro difere dependendo do tipo de evento. Para eventos em que uma alteração é feita no pacote indicado, a versão alterada é passada como este parâmetro.

[in] layerId

A camada da qual a função de notificação foi chamada.

[in] context

O contexto usado para marcar os pacotes de interesse. Esse valor é o valor atribuído ao pacote pelo driver de texto explicativo e é usado para identificar o pacote.

[in] contextTag

A marca de contexto usada para associar os pacotes de interesse ao contexto do driver explicativo.

Valor de retorno

Nenhum

Observações

Essa função está associada a um driver de texto explicativo por uma chamada para FwpsNetBufferListAssociateContext0. Um driver de texto explicativo pode usar uma única função de notificação para manipular mensagens para várias listas de buffer associadas usando o contexto e a marca de contexto para diferenciar entre instâncias.

Requisitos

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