estrutura FWPS_FILTER2 (fwpstypes.h)

Artigo
08/23/2023

O FWPS_FILTER0 está disponível.

Sintaxe

typedef struct FWPS_FILTER2_ {
  UINT64                 filterId;
  FWP_VALUE0             weight;
  UINT16                 subLayerWeight;
  UINT16                 flags;
  UINT32                 numFilterConditions;
  FWPS_FILTER_CONDITION0 *filterCondition;
  FWPS_ACTION0           action;
  UINT64                 context;
  FWPM_PROVIDER_CONTEXT2 *providerContext;
} FWPS_FILTER2;

Membros

filterId

Um identificador em tempo de execução que identifica o filtro no mecanismo de filtro.

weight

Uma estrutura FWP_VALUE0 que contém um valor que especifica a importância do filtro em relação a outros filtros no mecanismo de filtro. Os filtros com um valor de peso mais alto são invocados primeiro. O tipo de dados especificado na estrutura FWP_VALUE0 é FWP_UINT64 ou FWP_EMPTY. Se o tipo de dados especificado na estrutura de FWP_VALUE0 for FWP_EMPTY, o mecanismo de filtro atribuirá automaticamente um peso ao filtro com base em quão específico o filtro testa os dados em comparação com os outros filtros no mecanismo de filtro.

subLayerWeight

Um valor que especifica a importância da subcamada do filtro em relação aos outros subcaminhos no mecanismo de filtro. Os filtros localizados em uma subcamada com um valor subLayerWeight mais alto são invocados primeiro.

flags

Sinalizadores que especificam ações que a função de texto explicativo classifyFn2 de um texto explicativo deve tomar ao processar dados de rede. Os possíveis sinalizadores são:

Valor	Significado
FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT	Esse sinalizador indica para a função de texto explicativo classifyFn2 de um texto explicativo que ele sempre deve limpar o sinalizador FWPS_RIGHT_ACTION_WRITE quando retornar FWP_ACTION_BLOCK ou FWP_ACTION_PERMIT para a ação sugerida. Se esse sinalizador não estiver definido, a função de texto explicativo classifyFn2 de um texto explicativo só deverá limpar o sinalizador FWPS_RIGHT_ACTION_WRITE quando retornar FWP_ACTION_BLOCK para a ação sugerida.
FWPS_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED	Esse sinalizador indica para a função de texto explicativo classifyFn2 de um texto explicativo que, se o texto explicativo não estiver registrado, o texto explicativo deverá ser tratado como um filtro de permissão.

Valor

Significado

FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT

Esse sinalizador indica para a função de texto explicativo classifyFn2 de um texto explicativo que ele sempre deve limpar o sinalizador FWPS_RIGHT_ACTION_WRITE quando retornar FWP_ACTION_BLOCK ou FWP_ACTION_PERMIT para a ação sugerida. Se esse sinalizador não estiver definido, a função de texto explicativo classifyFn2 de um texto explicativo só deverá limpar o sinalizador FWPS_RIGHT_ACTION_WRITE quando retornar FWP_ACTION_BLOCK para a ação sugerida.

FWPS_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED

Esse sinalizador indica para a função de texto explicativo classifyFn2 de um texto explicativo que, se o texto explicativo não estiver registrado, o texto explicativo deverá ser tratado como um filtro de permissão.

numFilterConditions

O número de estruturas FWPS_FILTER_CONDITION0 na matriz apontada pelo membro filterCondition . Esse membro pode ser zero.

filterCondition

Um ponteiro para uma matriz de estruturas de FWPS_FILTER_CONDITION0 . Essas estruturas definem as condições de filtragem em tempo de execução para o filtro. Se o membro numFilterConditions for zero, esse ponteiro será NULL.

action

Uma estrutura FWPS_ACTION0 que especifica a ação que o filtro deve tomar se todas as condições de filtragem do filtro forem verdadeiras.

context

Um valor de contexto associado ao filtro. Um texto explicativo pode definir esse membro para apontar para uma estrutura de contexto fornecida pelo driver de texto explicativo de dentro da função de texto explicativo notifyFn2 do driver de texto explicativo quando o filtro é adicionado ao mecanismo de filtro. Essa estrutura de contexto, opaca para o mecanismo de filtro, 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 a função de texto explicativo classifyFn2 do driver de texto explicativo.

providerContext

Um ponteiro para o contexto do provedor, que é formatado como uma estrutura FWPM_PROVIDER_CONTEXT2 . Se o filtro usar um texto explicativo e o texto explicativo tiver o sinalizador FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT definido, esse membro conterá o contexto do provedor da estrutura de FWPM_FILTER0 correspondente. Caso contrário, esse parâmetro será NULL.

Comentários

O mecanismo de filtro passa um ponteiro para uma estrutura de FWPS_FILTER2 para as funções de texto explicativo NotifyFn2 e classifyFn2 .

A ação de um filtro será executada somente se todas as condições de filtragem do filtro forem verdadeiras. Se nenhuma condição de filtragem for especificada no filtro, a ação especificada será sempre executada.

O membro providerContext fornece um mecanismo para um driver de texto explicativo recuperar contextos do provedor sem chamar o BFE (mecanismo de filtragem base).

Essa estrutura é essencialmente idêntica à versão anterior, FWPM_PROVIDER_CONTEXT2 estrutura no membro providerContext .