FWPS_CALLOUT_NOTIFY_FN3 função de retorno de chamada (fwpsu.h)

Versão 3 da função invocada durante a classificação quando um filtro de texto explicativo corresponde. A diferença é que esse retorno de chamada retorna uma estrutura FWPS_FILTER3 .

Sintaxe

FWPS_CALLOUT_NOTIFY_FN3 FwpsCalloutNotifyFn3;

NTSTATUS FwpsCalloutNotifyFn3(
  FWPS_CALLOUT_NOTIFY_TYPE notifyType,
  const GUID *filterKey,
  FWPS_FILTER3 *filter
)
{...}

Parâmetros

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.

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 Comentários.

filter

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

A função de texto explicativo notifyFn3 de um texto explicativo pode definir o membro de contexto 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 classifyFn3 do driver de texto explicativo para preservar quaisquer dados específicos do driver ou informações de estado entre chamadas pelo mecanismo de filtro para a função de texto explicativo classifyFn3 do driver de texto explicativo.

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

Retornar valor

A função notifyFn3 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 de 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 de texto explicativo notifyFn3 de um texto explicativo para notificar o driver de texto explicativo sobre os eventos associados ao texto explicativo. Se a função de texto explicativo notifyFn3 do driver de texto explicativo não reconhecer o tipo de notificação passada no parâmetro notifyType , ela 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 de texto explicativo notifyFn3 do driver de texto explicativo para notificar o texto explicativo sobre qualquer um dos filtros existentes. O mecanismo de filtro chama a função de texto explicativo notifyFn3 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 de texto explicativo notifyFn3 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 de texto explicativo notifyFn3 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, consulte Processando textos explicativos de notificação.

Requisitos

Requisito	Valor
Cabeçalho	fwpsu.h