Partager via

FWPS_CALLOUT_CLASSIFY_FN3 fonction de rappel (fwpsk.h)

  • Article

Version 3 de la fonction de rappel appelée pendant la classification lorsqu’un filtre de légende correspond. La différence étant que ce rappel retourne une structure FWPS_FILTER3.

Syntaxe

FWPS_CALLOUT_CLASSIFY_FN3 FwpsCalloutClassifyFn3;

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

Paramètres

inFixedValues

Pointeur vers une structure FWPS_INCOMING_VALUES0. Cette structure contient les valeurs de chacun des champs de données au niveau de la couche filtrée.

inMetaValues

Pointeur vers une structure FWPS_INCOMING_METADATA_VALUES0. Cette structure contient les valeurs de chacun des champs de métadonnées au niveau de la couche filtrée.

layerData

Pointeur vers une structure qui décrit les données brutes au niveau de la couche filtrée. Ce paramètre peut être NULL, selon la couche filtrée et les conditions dans lesquelles la fonction de légende classifierFn3 est appelée. Pour la couche de flux, ce paramètre pointe vers une structure FWPS_STREAM_CALLOUT_IO_PACKET0. Pour toutes les autres couches, ce paramètre pointe vers une structure NET_BUFFER_LIST si elle n’est pas NULL.

classifyContext

Pointeur vers les données de contexte associées au pilote de légende par le moteur de filtre.

filter

Pointeur vers une structure FWPS_FILTER3. Cette structure décrit le filtre qui spécifie la légende de l’action du filtre.

flowContext

Variable typée UINT64 qui contient le contexte associé au flux de données. Si aucun contexte n’est associé au flux de données, ce paramètre est égal à zéro. Si la légende est ajoutée au moteur de filtre dans une couche de filtrage qui ne prend pas en charge les flux de données, la classifierFn3 fonction de légende doit ignorer ce paramètre.

classifyOut

Pointeur vers une structure FWPS_CLASSIFY_OUT0 qui reçoit les données que la fonction de légende classifieFn3 retourne à l’appelant.

Valeur de retour

Aucun

Remarques

Un pilote de légende inscrit les fonctions de légende d’un légende auprès du moteur de filtre en appelant la fonction FwpsCalloutRegister2.

Le moteur de filtre appelle la fonction de légende classifierFn3 fonction de légende avec des données à traiter chaque fois que toutes les conditions de test sont vraies pour un filtre dans le moteur de filtre qui spécifie la légende de l’action du filtre.

La fonction de légende classifieFn1 de légende doit effacer l’indicateur de FWPS_RIGHT_ACTION_WRITE dans les droits de membre de la structure FWPS_CLASSIFY_OUT0 dans l’une des situations suivantes :

  • Lorsque la fonction de légende classifierFn1 définit le membre actionType de la structure FWPS_CLASSIFY_OUT0 sur FWP_ACTION_BLOCK.
  • Lorsque la fonction de légende classifieFn1 définit le membre actionType de la structure FWPS_CLASSIFY_OUT0 sur FWP_ACTION_PERMIT et que l’indicateur FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT est défini dans le membre indicateurs de la structure FWPS_FILTER3.
  • Lorsqu’une légende a indiqué qu’elle a l’intention de modifier la liste de mémoires tampons du clone net en définissant le paramètre intendToModify sur TRUE dans un appel à la fonction FwpsReferenceNetBufferList0.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows Vista.
d’en-tête fwpsk.h
IRQL <= DISPATCH_LEVEL

Voir aussi