FWPS_CALLOUT_NOTIFY_FN2 Rückruffunktion (fwpsk.h)

Artikel
02/07/2025

Das Filtermodul ruft die notifyFn2 Popupfunktion eines Popups auf, um den Popuptreiber über Ereignisse zu benachrichtigen, die mit der Legende verknüpft sind.

HinweisnotifyFn2 ist die spezifische Version von notifyFn in Windows 8 und höher verwendet. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und zielspezifische Versionen von Windows. Für Windows 7 ist notifyFn1 verfügbar. Für Windows Vista ist notifyFn0 verfügbar.

Syntax

FWPS_CALLOUT_NOTIFY_FN2 FwpsCalloutNotifyFn2;

NTSTATUS FwpsCalloutNotifyFn2(
  [in]      FWPS_CALLOUT_NOTIFY_TYPE notifyType,
  [in]      const GUID *filterKey,
  [in, out] FWPS_FILTER2 *filter
)
{...}

Parameter

[in] notifyType

Ein Wert, der den Typ der Benachrichtigung angibt, die das Filtermodul an die Legende sendet. Gültige Werte für diesen Parameter sind:

FWPS_CALLOUT_NOTIFY_ADD_FILTER

Dem Filtermodul wird ein Filter hinzugefügt, der die Legende für die Aktion des Filters angibt.

FWPS_CALLOUT_NOTIFY_DELETE_FILTER

Ein Filter wird aus dem Filtermodul gelöscht, das die Legende für die Aktion des Filters angibt.

FWPS_CALLOUT_NOTIFY_TYPE_MAX

Ein Maximalwert für Testzwecke.

[in] filterKey

Ein Zeiger auf den Verwaltungsbezeichner für den Filter, wie durch die Anwendung oder den Treiber angegeben, die den Filter hinzufügen oder löschen. Muss NULL sein, wenn der parameter notifyType auf FWPS_CALLOUT_NOTIFY_DELETE_FILTER festgelegt ist. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in, out] filter

Ein Zeiger auf eine FWPS_FILTER2 Struktur. Diese Struktur beschreibt den Filter, der dem Filtermodul hinzugefügt oder gelöscht wird.

Die notifyFn2-Funktion eines Popuptreibers kann die Context Member dieser Struktur so festlegen, dass er auf eine vom Beschriftungstreiber bereitgestellte Kontextstruktur verweist, wenn der Filter dem Filtermodul hinzugefügt wird. Diese Kontextstruktur ist für das Filtermodul undurchsichtig und kann vom klassifizierenFn2 Legendenfunktion des Legendentreibers verwendet werden, um treiberspezifische Daten oder Zustandsinformationen zwischen Aufrufen des Filtermoduls für die Legendentreiber beizubehalten.
klassifizierenFn2 Legendenfunktion.

Die notifyFn2-Funktion eines Popuptreibers kann jeden Kontext bereinigen, der dem Filter zugeordnet ist, wenn der Filter aus dem Filtermodul gelöscht wird.

Rückgabewert

Die notifyFn2-Funktion eines Popups gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Popuptreiber akzeptiert die Benachrichtigung vom Filtermodul.
Andere Statuscodes	Fehler. Wenn der notifyType Parameter FWPS_CALLOUT_NOTIFY_ADD_FILTER ist, wird der Filter nicht zum Filtermodul hinzugefügt. Wenn der notifyType Parameter FWPS_CALLOUT_NOTIFY_DELETE_FILTER ist, wird der Filter weiterhin aus dem Filtermodul gelöscht.

Bemerkungen

Ein Legendentreiber registriert die Legendenfunktionen einer Legende mit dem Filtermodul, indem die FwpsCalloutRegister2-Funktion aufgerufen wird.

Das Filtermodul ruft die notifyFn2-Funktion eines Popuptreibers auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Legende zugeordnet sind. Wenn die notifyFn2- funktion des Popuptreibers den Typ der Benachrichtigung, die im parameter "notifyType " "notifyType" übergeben wird, nicht erkennt, sollte die Benachrichtigung ignoriert und STATUS_SUCCESS zurückgegeben werden.

Wenn ein Beschriftungstreiber eine Legende mit dem Filtermodul registriert, nachdem Filter, die die Legende für die Aktion des Filters angeben, bereits dem Filtermodul hinzugefügt wurden, ruft das Filtermodul die notifyFn2-Funktion des Popuptreibers nicht auf, um die Legende über alle vorhandenen Filter zu benachrichtigen. Das Filtermodul ruft die notifyFn2-Funktion des Legendentreibers auf, um die Legende zu benachrichtigen, wenn neue Filter, die die Beschriftung für die Aktion des Filters angeben, dem Filtermodul hinzugefügt werden. In diesem Fall wird die notifyFn2-funktion eines Popups möglicherweise nicht für jeden Filter im Filtermodul aufgerufen, der die Legende für die Aktion des Filters angibt. Wenn ein Beschriftungstreiber eine Legende registriert, nachdem das Filtermodul gestartet wurde und die Legende über jeden Filter im Filtermodul informiert werden muss, der die Legende für die Aktion des Filters angibt, muss der Legendentreiber die entsprechenden Verwaltungsfunktionen aufrufen, um alle Filter im Filtermodul aufzählen und die resultierende Liste der Filter zu sortieren, um diejenigen zu finden, die die Legende für die Aktion des Filters angeben. Weitere Informationen zum Aufrufen dieser Funktionen finden Sie unter Aufrufen anderer Windows-Filterplattformfunktionen.

Wenn ein Filter, der eine Legende für die Aktion des Filters angibt, aus dem Filtermodul gelöscht wird, ruft das Filtermodul die popuptreiber notifyFn2-Funktion auf und übergibt FWP_CALLOUT_NOTIFY_DELETE_FILTER im notifyType Parameter und NULL im parameter filterKey Parameter. Weitere Informationen finden Sie unter Verarbeitung von Benachrichtigungsanrufen.

Diese Funktion ist im Wesentlichen mit der vorherigen Version identisch, notifyFn1. Der einzige Unterschied ist die aktualisierte FWPS_FILTER2 Struktur, auf die durch den Filter Parameter verwiesen wird.