FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 fonction de rappel (fwpsk.h)

  • Article

Le moteur de filtre appelle la fonction de légende flowDeleteFn d’une légende pour informer la légende qu’un flux de données traité par la légende est en cours d’arrêt.

Syntaxe

FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 FwpsCalloutFlowDeleteNotifyFn0;

void FwpsCalloutFlowDeleteNotifyFn0(
  [in] UINT16 layerId,
  [in] UINT32 calloutId,
  [in] UINT64 flowContext
)
{...}

Paramètres

[in] layerId

Identificateur au moment de l’exécution pour la couche de filtrage à laquelle le flux de données est arrêté. Pour plus d’informations, consultez Identificateurs de couche de filtrage au moment de l’exécution.

[in] calloutId

Identificateur d’exécution de la légende dans le moteur de filtre. Il s’agit du même identificateur que celui qui a été retourné lorsque le pilote de légende a appelé les fonctions FwpsCalloutRegister0 ou FwpsCalloutRegister1 pour inscrire la légende auprès du moteur de filtre.

[in] flowContext

Contexte le plus récent associé au flux de données par un appel à la fonction FwpsFlowAssociateContext0 .

Valeur de retour

None

Remarques

Un pilote de légende inscrit les fonctions de légende d’une légende auprès du moteur de filtre en appelant les fonctions FwpsCalloutRegister0 ou FwpsCalloutRegister1 .

Le moteur de filtre appelle la fonction de légende flowDeleteFn d’une légende lorsqu’il met fin à un flux de données afin que la légende puisse propre le contexte associé au flux de données. Par exemple, cette fonction de légende sera appelée après un arrêt brusque de RST, sans que classFn soit appelé en premier. Le moteur de filtre appelle cette fonction de légende uniquement si le pilote de légende a associé un contexte au flux de données. Le contexte est automatiquement supprimé du flux de données par le moteur de filtre lorsque le flux de données se termine.

Le moteur de filtre appelle la fonction de légende flowDeleteFn d’une légende uniquement si la légende a été précédemment ajoutée au moteur de filtre au niveau d’une couche de filtrage qui prend en charge les flux de données et que le pilote de légende associe un contexte aux flux de données qu’il traite. Si un pilote de légende n’associe pas de contexte aux flux de données que la légende traite, il ne doit pas implémenter une fonction de légende flowDeleteFn pour la légende. Dans ce cas, le pilote de légende doit définir le
flowDeleteFn , membre de la FWPS_CALLOUT0 structure sur NULL lorsqu’il inscrit la légende auprès du moteur de filtre.

Le type FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 est défini comme pointeur vers la fonction flowDeleteFn comme suit.

typedef void (NTAPI *FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0) flowDeleteFn

Le moteur de filtre appelle la fonction de légende flowDeleteFn d’une légende à IRQL <= DISPATCH_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows Vista.
Plateforme cible Windows
En-tête fwpsk.h (inclure Fwpsk.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

Fonctions de légende du pilote de légende

FWPS_CALLOUT0

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0