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

Artigo
03/05/2024

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

ObserveFWPS_NET_BUFFER_LIST_NOTIFY_FN0 é a versão específica do FWPS_NET_BUFFER_LIST_NOTIFY_FN usado no Windows 7 e posterior. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações. Para 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 esse 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 de texto explicativo.

Retornar valor

Nenhum

Comentários

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 buffers associadas usando a marca de contexto e contexto para diferenciar entre instâncias.

Requisitos

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