FWPS_NET_BUFFER_LIST_NOTIFY_FN1 Rückruffunktion (fwpsk.h)

Artikel
02/26/2024

Die Filter-Engine ruft die FWPS_NET_BUFFER_LIST_NOTIFY_FN1-Beschriftungsfunktion auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die Paketen zugeordnet sind, die durch die Legende gekennzeichnet sind.

Beachten Sie FWPS_NET_BUFFER_LIST_NOTIFY_FN1 die spezifische Version von FWPS_NET_BUFFER_LIST_NOTIFY_FN ist, die in Windows 8 und höher verwendet wird. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen . 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 die Filter-Engine an die Legende sendet. Dieser Parameter wird auf einen der Werte der FWPS_NET_BUFFER_LIST_EVENT_TYPE0 Enumeration.

[in, out] netBufferList

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

[in, out, optional] newNetBufferList

Ein Zeiger auf eine aktualisierte Pufferliste, die Pakete enthält, die für den Legendentreiber 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 aus die Benachrichtigungsfunktion aufgerufen wurde.

[in] context

Der Kontext, der zum Markieren der relevanten Pakete verwendet wird. Dieser Wert ist der Wert, der dem Paket vom Legendentreiber zugewiesen wird und zum Identifizieren des Pakets verwendet wird.

[in] contextTag

Das Kontexttag, das verwendet wird, um die relevanten Pakete dem Kontext des Legendentreibers zuzuordnen.

Rückgabewert

Beschriftung einer Legende FWPS_NET_BUFFER_LIST_NOTIFY_FN1 Funktion 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.

Hinweise

Diese Funktion wird einem Legendentreiber durch einen Aufruf von FwpsNetBufferListAssociateContext1 zugeordnet. Ein Legendentreiber kann eine einzelne Benachrichtigungsfunktion verwenden, um Nachrichten für mehrere zugeordnete Pufferlisten zu verarbeiten, indem er den Kontext und das Kontexttag verwendet, um zwischen Instanzen zu unterscheiden.

Diese Funktion ist mit FWPS_NET_BUFFER_LIST_NOTIFY_FN0 identisch, mit der Ausnahme, dass der Rückgabetyp NTSTATUS anstelle von VOID ist.

Anforderungen

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