FWPS_CALLOUT_NOTIFY_FN0 Rückruffunktion (fwpsk.h)

Artikel
02/26/2024

Die Filter-Engine ruft die Beschriftungsfunktion notifyFn0 einer Legende auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Legende zugeordnet sind.

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

Syntax

FWPS_CALLOUT_NOTIFY_FN0 FwpsCalloutNotifyFn0;

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

Parameter

[in] notifyType

Ein -Wert, der den Typ der Benachrichtigung angibt, die die Filter-Engine 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, der 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, der von der Anwendung oder dem Treiber angegeben wird, 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_FILTER0-Struktur . Diese Struktur beschreibt den Filter, der der Filter-Engine hinzugefügt oder daraus gelöscht wird.

Die Beschriftungsfunktion notifyFn0 einer Legende kann festlegen, dass der Kontextmember 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 "klassifizierenFn0 " des Legendentreibers verwendet werden, um alle treiberspezifischen Daten oder Zustandsinformationen zwischen Aufrufen der Filter-Engine an den Legendentreiber beizubehalten.
klassifizierenFn0-Beschriftungsfunktion .

Die Beschriftungsfunktion notifyFn0 einer Legende kann jeden kontext, der dem Filter zugeordnet ist, sauber, wenn der Filter aus der Filter-Engine gelöscht wird.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Legendentreiber akzeptiert die Benachrichtigung von der Filter-Engine.
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 FwpsCalloutRegister0 aufruft.

Die Filter-Engine ruft die Beschriftungsfunktion notifyFn0 einer Legende auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Legende zugeordnet sind. Wenn die Legendenfunktion notifyFn0 des Legendentreibers den Benachrichtigungstyp, der im notifyType-Parameter übergeben wird, nicht erkennt, ignoriert sie die Benachrichtigung und gibt STATUS_SUCCESS zurück.

Wenn ein Legendentreiber eine Legende bei der Filter-Engine registriert, nachdem Filter, die die Beschriftung für die Filteraktion angeben, der Filter-Engine bereits hinzugefügt wurden, ruft die Filter-Engine die Callout-Funktion notifyFn0 des Legendentreibers nicht auf, um die Legende über einen der vorhandenen Filter zu benachrichtigen. Die Filter-Engine ruft die Beschriftungsfunktion notifyFn0 des Legendentreibers auf, um die Legende zu benachrichtigen, wenn der Filter-Engine neue Filter hinzugefügt werden, die die Legende für die Filteraktion angeben. In diesem Fall wird die Beschriftungsfunktion notifyFn0 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 jeden Filter in der Filter-Engine kennen muss, der die Beschriftung 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 Beschriftungsfunktion notifyFn0 des Legendentreibers auf und übergibt FWP_CALLOUT_NOTIFY_DELETE_FILTER im parameter notifyType und NULL im parameter filterKey . Weitere Informationen finden Sie unter Verarbeiten von Benachrichtigungs-Legenden.

Anforderungen

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