FWPS_NET_BUFFER_LIST_NOTIFY_FN1 Rückruffunktion (fwpsk.h)

Artikel
02/07/2025

Das Filtermodul ruft die FWPS_NET_BUFFER_LIST_NOTIFY_FN1 Popupfunktion auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die mit Paketen verknüpft sind, die durch die Legende gekennzeichnet sind.

Hinweis FWPS_NET_BUFFER_LIST_NOTIFY_FN1 ist die spezifische Version von FWPS_NET_BUFFER_LIST_NOTIFY_FN, die in Windows 8 und höher verwendet wird. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und zielspezifische Versionen von Windows. Für Windows 7 ist FWPS_NET_BUFFER_LIST_NOTIFY_FN0 verfügbar.

Syntax

FWPS_NET_BUFFER_LIST_NOTIFY_FN1 FwpsNetBufferListNotifyFn1;

NTSTATUS FwpsNetBufferListNotifyFn1(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out]           NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

Parameter

[in] eventType

Ein Wert, der den Typ der Benachrichtigung angibt, die das Filtermodul an die Legende sendet. Dieser Parameter wird auf einen der Werte der FWPS_NET_BUFFER_LIST_EVENT_TYPE0 Aufzählung.

[in, out] netBufferList

Ein Zeiger auf die Pufferliste, die Pakete enthält, die zuvor vom Popuptreiber als interessant gekennzeichnet wurden.

[in, out, optional] newNetBufferList

Ein Zeiger auf eine aktualisierte Pufferliste, die Pakete enthält, die für den Popuptreiber interessant sind. Die Verwendung dieses Parameters unterscheidet sich je nach Ereignistyp. Bei Ereignissen, bei denen eine Änderung am angegebenen Paket vorgenommen wird, wird die geänderte Version als dieser Parameter übergeben.

[in] layerId

Die Ebene, von der die Benachrichtigungsfunktion aufgerufen wurde.

[in] context

Der Kontext, der verwendet wird, um die Pakete von Interesse zu kategorisieren. Dieser Wert ist der Wert, der dem Paket vom Legendentreiber zugewiesen wird und verwendet wird, um das Paket zu identifizieren.

[in] contextTag

Das Kontexttag, das zum Zuordnen der interessanten Pakete zum Kontext des Popuptreibers verwendet wird.

Rückgabewert

Beschriftung FWPS_NET_BUFFER_LIST_NOTIFY_FN1 Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Popuptreiber akzeptiert die Benachrichtigung vom Filtermodul.
Andere Statuscodes	Fehler.

Bemerkungen

Diese Funktion wird einem Popuptreiber durch einen Aufruf von FwpsNetBufferListAssociateContext1zugeordnet. Ein Popuptreiber kann eine einzelne Benachrichtigungsfunktion verwenden, um Nachrichten für mehrere zugeordnete Pufferlisten mithilfe des Kontext- und Kontexttags zwischen Instanzen zu unterscheiden.

Diese Funktion ist identisch mit FWPS_NET_BUFFER_LIST_NOTIFY_FN0, außer dass der Rückgabetyp NTSTATUS- anstelle von VOIDist.