Compartilhar via


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

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

Observe FWPS_NET_BUFFER_LIST_NOTIFY_FN1 é a versão específica do FWPS_NET_BUFFER_LIST_NOTIFY_FN usado no Windows 8 e posterior. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações. Para o Windows 7, FWPS_NET_BUFFER_LIST_NOTIFY_FN0 está disponível.

 

Sintaxe

FWPS_NET_BUFFER_LIST_NOTIFY_FN1 FwpsNetBufferListNotifyFn1;

NTSTATUS FwpsNetBufferListNotifyFn1(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out]           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] 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

Um texto explicativo FWPS_NET_BUFFER_LIST_NOTIFY_FN1 função retorna um dos seguintes códigos NTSTATUS.

Código de retorno Descrição
STATUS_SUCCESS
O driver de texto explicativo aceita a notificação do mecanismo de filtro.
Outros códigos de status
Ocorreu um erro.

Comentários

Essa função é associada a um driver de texto explicativo por uma chamada para FwpsNetBufferListAssociateContext1. 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.

Essa função é idêntica a FWPS_NET_BUFFER_LIST_NOTIFY_FN0, exceto que o tipo de retorno é NTSTATUS em vez de VOID.

Requisitos

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

Confira também

Funções de texto explicativo do driver de texto explicativo

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

Usando a marcação de pacotes