structure FWPS_CALLOUT0 (fwpsk.h)

La structure FWPS_CALLOUT0 définit les données requises pour un pilote de légende afin d’inscrire une légende auprès du moteur de filtre.

NotezFWPS_CALLOUT0 est la version spécifique de FWPS_CALLOUT utilisée dans Windows Vista et versions ultérieures. Pour plus d’informations , voir PAM Version-Independent noms et ciblage de versions spécifiques de Windows . Pour Windows 8, FWPS_CALLOUT2 est disponible. Pour Windows 7, FWPS_CALLOUT1 est disponible.
 

Syntaxe

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;

Membres

calloutKey

GUID défini par le pilote de légende qui identifie de façon unique la légende.

flags

Indicateurs qui spécifient des paramètres spécifiques à la légende. Les indicateurs possibles sont les suivants :

FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW

Un pilote de légende peut spécifier cet indicateur lors de l’inscription d’une légende qui sera ajoutée à une couche qui prend en charge les flux de données. Si cet indicateur est spécifié, le moteur de filtre appelle la fonction de légende classFn0 du pilote de légende uniquement s’il existe un contexte associé au flux de données. Un pilote de légende associe un contexte à un flux de données en appelant la fonction FwpsFlowAssociateContext0 .

FWP_CALLOUT_FLAG_ALLOW_OFFLOAD

Un pilote de légende spécifie cet indicateur pour indiquer que la fonction de légende classFn0 du pilote de légende n’est pas affectée par le déchargement du traitement des données réseau pour décharger les cartes d’interface réseau compatibles. Si cet indicateur n’est pas spécifié, le déchargement du traitement des données réseau est désactivé pour tout le trafic traité par tous les filtres qui spécifient la légende de l’action du filtre.

classifyFn

Pointeur vers la fonction de légende classFn0 du pilote de légende. Le moteur de filtre appelle cette fonction chaque fois qu’il existe des données réseau à traiter par la légende.

notifyFn

Pointeur vers la fonction notifyFn0 du pilote de légende. Le moteur de filtre appelle cette fonction pour avertir le pilote de légende des événements associés à la légende.

flowDeleteFn

Pointeur vers la fonction de légende flowDeleteFn du pilote de légende. Le moteur de filtre appelle cette fonction chaque fois qu’un flux de données en cours de traitement par la légende est arrêté.

Si un pilote de légende n’associe pas de contexte aux flux de données que la légende traite, ce membre doit avoir la valeur NULL.

Remarques

Un pilote de légende transmet un pointeur à une structure de FWPS_CALLOUT0 initialisée à la fonction FwpsCalloutRegister0 lorsqu’il inscrit une légende auprès du moteur de filtre.

Une légende peut définir l’indicateur FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW uniquement pour les connexions sur lesquelles le pilote souhaite effectuer des inspections de flux. Cette légende est ignorée sur toutes les autres connexions. Les performances seront améliorées et le pilote n’aura pas besoin de conserver les données d’état inutiles.

Spécifications

   
Client minimal pris en charge Disponible à partir de Windows Vista.
En-tête fwpsk.h (inclure Fwpsk.h)

Voir aussi

FWPS_CALLOUT1

FWPS_CALLOUT2

FwpsCalloutRegister0

classFn0

flowDeleteFn

notifyFn0