FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 Rückruffunktion (fwpsk.h)
Das Filtermodul ruft die flowDeleteFn Legendenfunktion eines Popups auf, um die Legende 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 layer identifiers.
[in] calloutId
Der Laufzeitbezeichner für die Legende im Filtermodul. Dies ist derselbe Bezeichner, der zurückgegeben wurde, wenn der Legendentreiber entweder die FwpsCalloutRegister0- oder FwpsCalloutRegister1 Funktionen aufgerufen hat, um die Legende beim Filtermodul zu registrieren.
[in] flowContext
Der neueste Kontext, der dem Datenfluss durch einen Aufruf der FwpsFlowAssociateContext0--Funktion zugeordnet wurde.
Rückgabewert
Nichts
Bemerkungen
Ein Popuptreiber registriert die Legendenfunktionen eines Popups mit dem Filtermodul, indem entweder die funktionen FwpsCalloutRegister0 oder FwpsCalloutRegister1 aufgerufen werden.
Das Filtermodul ruft die flowDeleteFn Popupfunktion eines Popups auf, wenn er einen Datenfluss beendet, sodass die Legende den mit dem Datenfluss verknüpften Kontext bereinigen kann. Diese Popupfunktion wird beispielsweise nach einem abrupten Anhalten von RST aufgerufen, ohne dass klassifizierenFn zuerst aufgerufen wird. Das Filtermodul ruft diese Popupfunktion nur auf, wenn der Legendentreiber dem Datenfluss einen Kontext zugeordnet hat. Der Kontext wird automatisch vom Datenfluss vom Filtermodul entfernt, wenn der Datenfluss beendet wird.
Das Filtermodul ruft die flowDeleteFn Legendenfunktion eines Popups nur auf, wenn die Legende zuvor dem Filtermodul auf einer Filterebene hinzugefügt wurde, die Datenflüsse unterstützt, und der Legendentreiber ordnet einen Kontext mit den verarbeiteten Datenflüssen zu. Wenn ein Beschriftungstreiber keinen Kontext mit den Datenflüssen verknüpft, die von der Legende verarbeitet werden, sollte kein flowDeleteFn- Popupfunktion für die Legende implementiert werden. In diesem Fall sollte der Legendentreiber den
flowDeleteFn Member der FWPS_CALLOUT0 Struktur, um NULL-zu, wenn die Legende beim Filtermodul registriert wird.
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 Legendenfunktion eines Popups bei IRQL-<= DISPATCH_LEVEL auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows Vista. |
| Zielplattform- | Fenster |
| Header- | fwpsk.h (include Fwpsk.h) |
| IRQL- | <= DISPATCH_LEVEL |