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

O mecanismo de filtro chama a função de texto explicativo classifyFn2 de um texto explicativo sempre que há dados a serem processados pelo texto explicativo.

Observação

classifyFn2 é a versão específica do classifyFn usada no Windows 8 e posterior. Para obter mais informações, consulte Nomes independentes de versão do WFP e direcionamento a versões específicas do Windows. Para o Windows 7, classifyFn1 está disponível. Para o Windows Vista, classifyFn0 está disponível.

Sintaxe

FWPS_CALLOUT_CLASSIFY_FN2 FwpsCalloutClassifyFn2;

void FwpsCalloutClassifyFn2(
  const FWPS_INCOMING_VALUES0 *inFixedValues,
  const FWPS_INCOMING_METADATA_VALUES0 *inMetaValues,
  void *layerData,
  const void *classifyContext,
  const FWPS_FILTER2 *filter,
  UINT64 flowContext,
  FWPS_CLASSIFY_OUT0 *classifyOut
)
{...}

Parâmetros

inFixedValues

Um ponteiro para uma estrutura FWPS_INCOMING_VALUES0 . Essa estrutura contém os valores de cada um dos campos de dados na camada que está sendo filtrada.

inMetaValues

Um ponteiro para uma estrutura FWPS_INCOMING_METADATA_VALUES0 . Essa estrutura contém os valores de cada um dos campos de metadados na camada que está sendo filtrada.

layerData

Um ponteiro para uma estrutura que descreve os dados brutos na camada que está sendo filtrada. Esse parâmetro pode ser NULL, dependendo da camada que está sendo filtrada e das condições sob as quais a função de texto explicativo classifyFn2 é chamada. Para a camada de fluxo, esse parâmetro aponta para uma estrutura de FWPS_STREAM_CALLOUT_IO_PACKET0 . Para todas as outras camadas, esse parâmetro aponta para uma estrutura NET_BUFFER_LIST se não for NULL.

classifyContext

Um ponteiro para dados de contexto associados ao driver de texto explicativo pelo mecanismo de filtro.

filter

Um ponteiro para uma estrutura FWPS_FILTER2 . Essa estrutura descreve o filtro que especifica o texto explicativo para a ação do filtro.

flowContext

Uma variável do tipo UINT64 que contém o contexto associado ao fluxo de dados. Se nenhum contexto estiver associado ao fluxo de dados, esse parâmetro será zero. Se o texto explicativo for adicionado ao mecanismo de filtro em uma camada de filtragem que não dá suporte a fluxos de dados, a função de texto explicativo classifyFn2 deverá ignorar esse parâmetro.

classifyOut

Um ponteiro para uma estrutura FWPS_CLASSIFY_OUT0 que recebe todos os dados que a função de texto explicativo classifyFn2 retorna ao chamador.

Retornar valor

Nenhum

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 classifyFn2 de um texto explicativo com dados a serem processados sempre que todas as condições de teste forem verdadeiras para um filtro no mecanismo de filtro que especifica o texto explicativo para a ação do filtro.

A função de texto explicativo classifyFn1 de um texto explicativo deve limpar o sinalizador FWPS_RIGHT_ACTION_WRITE no membro de direitos da estrutura FWPS_CLASSIFY_OUT0 em qualquer uma das seguintes situações:

• Quando a função de texto explicativo classifyFn1 define o membro actionType da estrutura FWPS_CLASSIFY_OUT0 como FWP_ACTION_BLOCK.
• Quando a função de texto explicativo classifyFn1 define o membro actionType da estrutura FWPS_CLASSIFY_OUT0 como FWP_ACTION_PERMIT e o sinalizador FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT é definido no membro flags da estrutura FWPS_FILTER1 .
• Quando um texto explicativo indica que pretende modificar a lista de buffers de rede de clone definindo o parâmetro intendToModify como TRUE em uma chamada para a função FwpsReferenceNetBufferList0 .

Requisitos

Requisito	Valor
Cabeçalho	fwpsu.h