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

Artigo
08/07/2023

O mecanismo de filtro chama a função de texto explicativo notifyFn2 de um texto explicativo para notificar o driver de texto explicativo sobre eventos associados ao texto explicativo.

NotificarFn2 é a versão específica de notifyFn usada em Windows 8 e posteriores. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações. Para o Windows 7, notifyFn1 está disponível. Para o Windows Vista, notifyFn0 está disponível.

Sintaxe

FWPS_CALLOUT_NOTIFY_FN2 FwpsCalloutNotifyFn2;

NTSTATUS FwpsCalloutNotifyFn2(
  [in]      FWPS_CALLOUT_NOTIFY_TYPE notifyType,
  [in]      const GUID *filterKey,
  [in, out] FWPS_FILTER2 *filter
)
{...}

Parâmetros

[in] notifyType

Um valor que indica o tipo de notificação que o mecanismo de filtro está enviando para o texto explicativo. Os valores válidos para esse parâmetro são:

FWPS_CALLOUT_NOTIFY_ADD_FILTER

Um filtro está sendo adicionado ao mecanismo de filtro que especifica o texto explicativo para a ação do filtro.

FWPS_CALLOUT_NOTIFY_DELETE_FILTER

Um filtro está sendo excluído do mecanismo de filtro que especifica o texto explicativo para a ação do filtro.

FWPS_CALLOUT_NOTIFY_TYPE_MAX

Um valor máximo para fins de teste.

[in] filterKey

Um ponteiro para o identificador de gerenciamento do filtro, conforme especificado pelo aplicativo ou driver que está adicionando ou excluindo o filtro. Deve ser NULL se o parâmetro notifyType estiver definido como FWPS_CALLOUT_NOTIFY_DELETE_FILTER. Para obter mais informações, consulte a seção Comentários a seguir.

[in, out] filter

Um ponteiro para uma estrutura FWPS_FILTER2 . Essa estrutura descreve o filtro que está sendo adicionado ou excluído do mecanismo de filtro.

A função notifyFn2 de um driver de texto explicativo pode definir o membro contextual dessa estrutura para apontar para uma estrutura de contexto fornecida pelo driver de texto explicativo quando o filtro é adicionado ao mecanismo de filtro. Essa estrutura de contexto é opaca para o mecanismo de filtro e pode ser usada pela função de texto explicativo classifyFn2 do driver de texto explicativo para preservar dados específicos do driver ou informações de estado entre chamadas pelo mecanismo de filtro para o driver de texto explicativo
função de texto explicativo classifyFn2 .

A função notifyFn2 de um driver de texto explicativo pode limpo qualquer contexto associado ao filtro quando o filtro é excluído do mecanismo de filtro.

Retornar valor

A função notifyFn2 de um texto explicativo 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 status	Ocorreu um erro. Se o parâmetro notifyType for FWPS_CALLOUT_NOTIFY_ADD_FILTER, o filtro não será adicionado ao mecanismo de filtro. Se o parâmetro notifyType for FWPS_CALLOUT_NOTIFY_DELETE_FILTER, o filtro ainda será excluído do mecanismo de filtro.

Comentários

Um driver de texto explicativo registra as funções de texto explicativo de um texto explicativo com o mecanismo de filtro chamando a função FwpsCalloutRegister2 .

O mecanismo de filtro chama a função notifyFn2 de um driver de texto explicativo para notificar o driver de texto explicativo sobre os eventos associados ao texto explicativo. Se a função notifyFn2 do driver de texto explicativo não reconhecer o tipo de notificação que é passado no parâmetro notifyType , ela deverá ignorar a notificação e retornar STATUS_SUCCESS.

Se um driver de texto explicativo registrar um texto explicativo com o mecanismo de filtro após filtros que especificam o texto explicativo para a ação do filtro já tiverem sido adicionados ao mecanismo de filtro, o mecanismo de filtro não chamará a função notifyFn2 do driver de texto explicativo para notificar o texto explicativo sobre qualquer um dos filtros existentes. O mecanismo de filtro chama a função notifyFn2 do driver de texto explicativo para notificar o texto explicativo quando novos filtros que especificam o texto explicativo para a ação do filtro são adicionados ao mecanismo de filtro. Nessa situação, a função notifyFn2 de um texto explicativo pode não ser chamada para cada filtro no mecanismo de filtro que especifica o texto explicativo para a ação do filtro. Se um driver de texto explicativo registrar um texto explicativo depois que o mecanismo de filtro for iniciado e o texto explicativo precisar saber sobre cada filtro no mecanismo de filtro que especifica o texto explicativo para a ação do filtro, o driver de texto explicativo deverá chamar as funções de gerenciamento apropriadas para enumerar todos os filtros no mecanismo de filtro e classificar por meio da lista resultante de filtros para localizar aqueles que especificam o texto explicativo para a ação do filtro. Consulte Chamando outras funções da plataforma de filtragem do Windows para obter mais informações sobre como chamar essas funções.

Quando um filtro que especifica um texto explicativo para a ação do filtro é excluído do mecanismo de filtro, o mecanismo de filtro chama a função notifyFn2 do driver de texto explicativo e passa FWP_CALLOUT_NOTIFY_DELETE_FILTER no parâmetro notifyType e NULL no parâmetro filterKey . Para obter mais informações, confira Processando textos explicativos de notificação.

Essa função é essencialmente idêntica à versão anterior, notifyFn1. A única diferença é a estrutura de FWPS_FILTER2 atualizada apontada pelo parâmetro de filtro .

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