FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 Rückruffunktion (fwpsk.h)

Das Filtermodul ruft die FlowDeleteFn-Funktion eines Callouts auf, um das Callout zu benachrichtigen, dass ein Datenfluss, der vom Callout verarbeitet wird, beendet wird.

Syntax

FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 FwpsCalloutFlowDeleteNotifyFn0;

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

Parameter

[in] layerId

Der Laufzeitbezeichner für die Filterebene, bei der der Datenfluss beendet wird. Weitere Informationen finden Sie unter Laufzeitfilterung von Layer-Bezeichnern.

[in] calloutId

Der Laufzeitbezeichner für das Callout im Filtermodul. Dies ist der gleiche Bezeichner, der zurückgegeben wurde, wenn der Callouttreiber entweder das FwpsCalloutRegister0 oder fwpsCalloutRegister1-Funktionen aufgerufen hat, um das Callout mit dem Filtermodul zu registrieren.

[in] flowContext

Der neueste Kontext, der dem Datenfluss zugeordnet wurde, durch einen Aufruf der Funktion FwpsFlowAssociateContext0 .

Rückgabewert

Keine

Bemerkungen

Ein Callouttreiber registriert die Calloutfunktionen eines Callouts mit dem Filtermodul, indem sie entweder die Funktionen fwpsCalloutRegister0 oder FwpsCalloutRegister1 aufrufen.

Das Filtermodul ruft die FlowDeleteFn-Funktion eines Callouts auf, wenn er einen Datenfluss beendet, sodass der Anrufer den Kontext bereinigen kann, der dem Datenfluss zugeordnet ist. Diese Callout-Funktion wird beispielsweise nach einem abrupten Stopp von RST aufgerufen, ohne zuerst klassifizierenFn aufgerufen zu werden. Das Filtermodul ruft diese Calloutfunktion nur auf, wenn der Callouttreiber einem Kontext mit dem Datenfluss zugeordnet ist. Der Kontext wird automatisch vom Datenfluss durch das Filtermodul entfernt, wenn der Datenfluss beendet wird.

Das Filtermodul ruft die FlowDeleteFn-Calloutfunktion eines Callouts nur auf, wenn das Callout zuvor dem Filtermodul in einer Filterebene hinzugefügt wurde, die Datenflüsse unterstützt und der Rückruftreiber einen Kontext mit den Datenflüssen verknüpft, die er verarbeitet. Wenn ein Callouttreiber keinen Kontext mit den Datenflüssen verknüpft, die die Callout-Prozesse verarbeiten, sollte es keine FlowDeleteFn-Calloutfunktion für das Callout implementieren. In dieser Situation sollte der Callouttreiber die Option festlegen.
flowDeleteFn-Element der FWPS_CALLOUT0-Struktur auf NULL , wenn sie das Callout mit dem Filtermodul registriert.

Der FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0-Typ wird wie folgt als Zeiger auf die FlowDeleteFn-Funktion definiert.

typedef void (NTAPI *FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0) flowDeleteFn

Das Filtermodul ruft die FlowDeleteFn-Funktion eines Callouts bei IRQL <= DISPATCH_LEVEL auf.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar ab Windows Vista.
Zielplattform Windows
Kopfzeile fwpsk.h (enthalten Fwpsk.h)
IRQL <= DISPATCH_LEVEL

Weitere Informationen

Callout-Treiberfunktionen

FWPS_CALLOUT0

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0