FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 Rückruffunktion (fwpsu.h)

Die Filter-Engine ruft die callout-Funktion flowDeleteFn einer Legende auf, um die Legende darüber zu benachrichtigen, dass ein Datenfluss, der von der Legende verarbeitet wird, beendet wird.

Syntax

FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 FwpsCalloutFlowDeleteNotifyFn0;

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

Parameter

layerId

Der Laufzeitbezeichner für die Filterebene, auf der der Datenfluss beendet wird. Weitere Informationen finden Sie unter Filtern von Ebenenbezeichnern.

calloutId

Der Laufzeitbezeichner für die Beschriftung in der Filter-Engine. Dies ist derselbe Bezeichner, der zurückgegeben wurde, als der Legendentreiber entweder die Funktionen FwpsCalloutRegister0 oder FwpsCalloutRegister1 aufgerufen hat, um die Legende bei der Filter-Engine zu registrieren.

flowContext

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

Rückgabewert

Keine

Bemerkungen

Ein Legendentreiber registriert die Legendenfunktionen einer Legende bei der Filter-Engine, indem er entweder die Funktionen FwpsCalloutRegister0 oder FwpsCalloutRegister1 aufruft.

Die Filter-Engine ruft die callout-Funktion flowDeleteFn einer Legende auf, wenn sie einen Datenfluss beendet, sodass die Legende den dem Datenfluss zugeordneten Kontext bereinigen kann. Beispielsweise wird diese Legendenfunktion nach einem abrupten Anhalten von RST aufgerufen, ohne dass klassifizierenFn zuerst aufgerufen wird. Die Filter-Engine ruft diese Beschriftungsfunktion nur auf, wenn der Legendentreiber dem Datenfluss einen Kontext zugeordnet hat. Der Kontext wird automatisch von der Filter-Engine aus dem Datenfluss entfernt, wenn der Datenfluss beendet wird.

Die Filter-Engine ruft die callout-Funktion flowDeleteFn einer Legende nur auf, wenn die Legende zuvor der Filter-Engine auf einer Filterebene hinzugefügt wurde, die Datenflüsse unterstützt, und der Legendentreiber einen Kontext mit den verarbeiteten Datenflüssen verknüpft. Wenn ein Legendentreiber den Datenflüssen, die die Legende verarbeitet, keinen Kontext ordnet, sollte er keine flowDeleteFn-Legendenfunktion für die Legende implementieren. In dieser Situation sollte der Legendentreiber den flowDeleteFn-Member der FWPS_CALLOUT0-Struktur auf NULL festlegen, wenn er die Legende bei der Filter-Engine 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

Die Filter-Engine ruft die Calloutfunktion flowDeleteFn einer Legende unter IRQL <= DISPATCH_LEVEL auf.

Anforderungen

Anforderung	Wert
Header	fwpsu.h