estrutura FWPS_CALLOUT1 (fwpsk.h)
A estrutura FWPS_CALLOUT1 define os dados necessários para que um driver de texto explicativo registre um texto explicativo com o mecanismo de filtro.
Sintaxe
typedef struct FWPS_CALLOUT1_ {
GUID calloutKey;
UINT32 flags;
FWPS_CALLOUT_CLASSIFY_FN1 classifyFn;
FWPS_CALLOUT_NOTIFY_FN1 notifyFn;
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT1;
Membros
calloutKey
Um GUID de definido pelo driver explicativo que identifica exclusivamente o texto explicativo.
flags
Sinalizadores que especificam parâmetros específicos do texto explicativo. Os sinalizadores possíveis são:
| Valor | Significado |
|---|---|
|
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á o driver de texto explicativo classificarFn1 função 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. |
|
Um driver de texto explicativo especifica esse sinalizador para indicar que a função de texto explicativo classificarFn1 função de texto explicativo não é afetada pelo descarregamento do processamento de dados de rede para NICs (cartões 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 quaisquer filtros que especifiquem o texto explicativo para a ação do filtro. |
|
Um driver explicativo especifica esse sinalizador para indicar que ele pode receber notificações sobre objetos e filtros que são adicionados dentro de uma transação. O mecanismo de filtro envia a notificação depois que a transação é confirmada. |
|
Um driver de texto explicativo especifica esse sinalizador para indicar que ele pode executar a inspeção dinâmica de fluxos de dados no nível do fluxo de fluxos. Consulte de Inspeção de Fluxo. |
|
Um driver explicativo especifica esse sinalizador para se registrar para ser chamado quando uma operação de soquete existente for reclassificada. |
classifyFn
Um ponteiro para a função de texto explicativo classificarFn1 função 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 do driver de texto explicativo notifyFn1. 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.
Observações
Um driver de texto explicativo passa um ponteiro para uma estrutura de FWPS_CALLOUT1 inicializada para a função FwpsCalloutRegister1 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.
Essa estrutura é essencialmente idêntica à versão anterior, FWPS_CALLOUT0. As únicas diferenças são que os membros dessa versão armazenam as versões atualizadas dos ponteiros de função de texto explicativo e sinalizadores adicionais estão disponíveis para os drivers de texto explicativo definirem.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 7. |
| cabeçalho | fwpsk.h (inclua Fwpsk.h) |
Consulte também
classificar Fn1