FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 Rückruffunktion (fwpsk.h)
Die Filter-Engine ruft die Legendenfunktion 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(
[in] UINT16 layerId,
[in] UINT32 calloutId,
[in] UINT64 flowContext
)
{...}
Parameter
[in] layerId
Der Laufzeitbezeichner für die Filterebene, auf der der Datenfluss beendet wird. Weitere Informationen finden Sie unter Laufzeitfilterung von Ebenenbezeichnern.
[in] calloutId
Der Laufzeitbezeichner für die Legende 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.
[in] 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 Beschriftungsfunktion flowDeleteFn einer Legende auf, wenn sie einen Datenfluss beendet, sodass die Legende den dem Datenfluss zugeordneten Kontext sauber kann. Diese Beschriftungsfunktion wird beispielsweise nach einem abrupten Anhalten von RST aufgerufen, ohne dass zuerst klassifizierenFn 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 Beschriftungsfunktion 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 den verarbeiteten Datenflüssen einen Kontext zuordnet. Wenn ein Legendentreiber den Datenflüssen, die die Legende verarbeitet, keinen Kontext zuordnet, sollte er keine flowDeleteFn-Beschriftungsfunktion für die Legende implementieren. In diesem Fall sollte der Legendentreiber die
flowDeleteFn-Member der FWPS_CALLOUT0-Struktur auf NULL , wenn die Legende bei der Filter-Engine registriert wird.
Der FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 Typ wird wie folgt als Zeiger auf die funktion flowDeleteFn 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows Vista. |
| Zielplattform | Windows |
| Kopfzeile | fwpsk.h (include Fwpsk.h) |
| IRQL | <= DISPATCH_LEVEL |