estrutura FWPS_CALLOUT0 (fwpsk.h)

Artigo
08/07/2023

A estrutura FWPS_CALLOUT0 define os dados necessários para que um driver de texto explicativo registre um texto explicativo com o mecanismo de filtro.

ObservaçãoFWPS_CALLOUT0 é a versão específica do FWPS_CALLOUT usada no Windows Vista e posteriores. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações. Para Windows 8, FWPS_CALLOUT2 está disponível. Para o Windows 7, FWPS_CALLOUT1 está disponível.

Sintaxe

typedef struct FWPS_CALLOUT0_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN0           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN0             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT0;

Membros

calloutKey

Um GUID definido pelo driver de texto explicativo que identifica exclusivamente o texto explicativo.

flags

Sinalizadores que especificam parâmetros específicos do texto explicativo. Os possíveis sinalizadores são:

FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW

Um driver de texto explicativo pode especificar esse sinalizador ao registrar um texto explicativo que será adicionado em uma camada que dá suporte a fluxos de dados. Se esse sinalizador for especificado, o mecanismo de filtro chamará a função de texto explicativo classifyFn0 do driver de texto explicativo somente se houver um contexto associado ao fluxo de dados. Um driver de texto explicativo associa um contexto a um fluxo de dados chamando a função FwpsFlowAssociateContext0 .

FWP_CALLOUT_FLAG_ALLOW_OFFLOAD

Um driver de texto explicativo especifica esse sinalizador para indicar que a função de texto explicativo classifyFn0 do driver de texto explicativo não é afetada pelo descarregamento do processamento de dados de rede para NICs (placas de interface de rede) compatíveis com descarregamento. Se esse sinalizador não for especificado, o descarregamento do processamento de dados de rede será desabilitado para todo o tráfego processado por qualquer filtro que especifique o texto explicativo para a ação do filtro.

classifyFn

Um ponteiro para a função de texto explicativo classifyFn0 do driver de texto explicativo. O mecanismo de filtro chama essa função sempre que há dados de rede a serem processados pelo texto explicativo.

notifyFn

Um ponteiro para a função notifyFn0 do driver de texto explicativo. O mecanismo de filtro chama essa função para notificar o driver de texto explicativo sobre os eventos associados ao texto explicativo.

flowDeleteFn

Um ponteiro para a função de texto explicativo flowDeleteFn do driver de texto explicativo. O mecanismo de filtro chama essa função sempre que um fluxo de dados que está sendo processado pelo texto explicativo é encerrado.

Se um driver de texto explicativo não associar um contexto aos fluxos de dados que o texto explicativo processa, esse membro deverá ser definido como NULL.

Comentários

Um driver de texto explicativo passa um ponteiro para uma estrutura de FWPS_CALLOUT0 inicializada para a função FwpsCalloutRegister0 quando registra um texto explicativo com o mecanismo de filtro.

Um texto explicativo pode definir o sinalizador FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW somente para conexões nas quais o driver está interessado em executar inspeções de fluxo. Esse texto explicativo será ignorado em todas as outras conexões. O desempenho será melhorado e o driver não precisará manter dados de estado desnecessários.