FWPS_CALLOUT_NOTIFY_FN1 Rückruffunktion (fwpsk.h)

Artikel
02/29/2024

Das Filtermodul ruft die Calloutfunktion notifyFn1 einer Legende auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Legende zugeordnet sind.

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

Syntax

FWPS_CALLOUT_NOTIFY_FN1 FwpsCalloutNotifyFn1;

NTSTATUS FwpsCalloutNotifyFn1(
  [in] FWPS_CALLOUT_NOTIFY_TYPE notifyType,
  [in] const GUID *filterKey,
  [in] FWPS_FILTER1 *filter
)
{...}

Parameter

[in] notifyType

Ein Wert, der den Typ der Benachrichtigung angibt, die das Filtermodul an die Legende sendet. Gültige Parameterwerte:

FWPS_CALLOUT_NOTIFY_ADD_FILTER

Der Filter-Engine wird ein Filter hinzugefügt, der die Beschriftung für die Aktion des Filters angibt.

FWPS_CALLOUT_NOTIFY_DELETE_FILTER

Ein Filter wird aus der Filter-Engine gelöscht, die die Beschriftung 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 von der Anwendung oder dem Treiber angegeben, der den Filter hinzufügt oder löscht. Muss NULL sein, wenn der notifyType-Parameter auf FWPS_CALLOUT_NOTIFY_DELETE_FILTER festgelegt ist. Weitere Informationen finden Sie in den Hinweisen.

[in] filter

Ein Zeiger auf eine FWPS_FILTER1 Struktur. Diese Struktur beschreibt den Filter, der der Filter-Engine hinzugefügt oder gelöscht wird.

Die Funktion notifyFn1 eines Legendentreibers kann festlegen, dass das Context-Element dieser Struktur auf eine vom Legendentreiber bereitgestellte Kontextstruktur verweist, wenn der Filter der Filter-Engine hinzugefügt wird. Diese Kontextstruktur ist für die Filter-Engine undurchsichtig und kann von der Legendenfunktion klassifizierenFn1 des Legendentreibers verwendet werden, um alle treiberspezifischen Daten oder Zustandsinformationen zwischen Aufrufen der Filter-Engine für die Legendentreiber beizubehalten.
klassifizierenFn1-Legendenfunktion .

Die Funktion notifyFn1 eines Legendentreibers kann jeden kontext, der dem Filter zugeordnet ist, sauber, wenn der Filter aus der Filter-Engine gelöscht wird.

Rückgabewert

Die Funktion notifyFn1 einer Legende gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Legendentreiber akzeptiert die Benachrichtigung vom Filtermodul.
Andere status Codes	Ein Fehler ist aufgetreten. Wenn der notifyType-Parameter FWPS_CALLOUT_NOTIFY_ADD_FILTER ist, wird der Filter nicht zur Filter-Engine hinzugefügt. Wenn der notifyType-Parameter FWPS_CALLOUT_NOTIFY_DELETE_FILTER ist, wird der Filter weiterhin aus der Filter-Engine gelöscht.

Hinweise

Ein Legendentreiber registriert die Legendenfunktionen einer Legende bei der Filter-Engine, indem er die Funktion FwpsCalloutRegister1 aufruft.

Das Filtermodul ruft die Funktion notifyFn1 eines Legendentreibers auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Legende zugeordnet sind. Wenn die Funktion notifyFn1 des Legendentreibers den Benachrichtigungstyp, der im notifyType-Parameter übergeben wird, nicht erkennt, sollte sie die Benachrichtigung ignorieren und STATUS_SUCCESS zurückgeben.

Wenn ein Legendentreiber eine Legende bei der Filter-Engine registriert, nachdem Filter, die die Beschriftung für die Aktion des Filters angeben, der Filter-Engine bereits hinzugefügt wurden, ruft das Filtermodul die Funktion notifyFn1 des Legendentreibers nicht auf, um die Legende über einen der vorhandenen Filter zu benachrichtigen. Die Filter-Engine ruft die Funktion notifyFn1 des Legendentreibers auf, um die Legende zu benachrichtigen, wenn der Filter-Engine neue Filter hinzugefügt werden, die die Legende für die Aktion des Filters angeben. In dieser Situation wird die notifyFn1-Funktion einer Legende möglicherweise nicht für jeden Filter in der Filter-Engine aufgerufen, die die Legende für die Aktion des Filters angibt. Wenn ein Legendentreiber eine Legende registriert, nachdem die Filter-Engine gestartet wurde und die Legende über jeden Filter in der Filter-Engine wissen muss, der die Legende für die Aktion des Filters angibt, muss der Legendentreiber die entsprechenden Verwaltungsfunktionen aufrufen, um alle Filter in der Filter-Engine aufzulisten 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 der Filter-Engine gelöscht wird, ruft die Filter-Engine die Funktion notifyFn1 des Legendentreibers auf und übergibt FWP_CALLOUT_NOTIFY_DELETE_FILTER im notifyType-Parameter und NULL im filterKey-Parameter . Weitere Informationen finden Sie unter Verarbeiten von Benachrichtigungs-Legenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 7.
Zielplattform	Windows
Kopfzeile	fwpsk.h (include fwpsk.h)
IRQL	<= DISPATCH_LEVEL