FWPS_CALLOUT_NOTIFY_FN3 Rückruffunktion (fwpsu.h)

Artikel
06/12/2024

Version 3 der Funktion, die während der Klassifizierung aufgerufen wird, wenn ein Legendenfilter übereinstimmt. Der Unterschied ist, dass dieser Rückruf eine FWPS_FILTER3 Struktur zurückgibt.

Syntax

FWPS_CALLOUT_NOTIFY_FN3 FwpsCalloutNotifyFn3;

NTSTATUS FwpsCalloutNotifyFn3(
  FWPS_CALLOUT_NOTIFY_TYPE notifyType,
  const GUID *filterKey,
  FWPS_FILTER3 *filter
)
{...}

Parameter

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.

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.

filter

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

Die Beschriftungsfunktion notifyFn3 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 Callout-Treiberfunktion klassifizierenFn3 verwendet werden, um alle treiberspezifischen Daten oder Zustandsinformationen zwischen Aufrufen der Filter-Engine für die Legendenfunktion klassifizierenFn3 des Legendentreibers beizubehalten.

Die Calloutfunktion notifyFn3 einer Legende kann jeden kontext bereinigen, der dem Filter zugeordnet ist, wenn der Filter aus der Filter-Engine gelöscht wird.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Legendentreiber akzeptiert die Benachrichtigung vom Filtermodul.
Andere Statuscodes	Ein Fehler ist aufgetreten. Wenn der notifyType-ParameterFWPS_CALLOUT_NOTIFY_ADD_FILTER ist, wird der Filter nicht zur Filter-Engine hinzugefügt. Wenn der notifyType-ParameterFWPS_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 FwpsCalloutRegister2 aufruft.

Das Filtermodul ruft die Calloutfunktion notifyFn3 einer Legende auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Legende zugeordnet sind. Wenn die Callout-Funktion notifyFn3 des Legendentreibers den Typ der im notifyType-Parameter übergebenen Benachrichtigung 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 Aktion des Filters angeben, der Filter-Engine bereits hinzugefügt wurden, ruft das Filtermodul nicht die Callout-Funktion notifyFn3 des Legendentreibers auf, um die Legende über einen der vorhandenen Filter zu benachrichtigen. Die Filter-Engine ruft die Callout-Funktion notifyFn3 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 Calloutfunktion notifyFn3 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 Callout-Funktion notifyFn3 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
Header	fwpsu.h

Freigeben über