FWPS_NET_BUFFER_LIST_NOTIFY_FN0 Rückruffunktion (fwpsk.h)

Artikel
03/01/2024

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

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

Syntax

FWPS_NET_BUFFER_LIST_NOTIFY_FN0 FwpsNetBufferListNotifyFn0;

void FwpsNetBufferListNotifyFn0(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out, optional] 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, optional] 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

Keine

Bemerkungen

Diese Funktion wird einem Legendentreiber durch einen Aufruf von zugeordnet. FwpsNetBufferListAssociateContext0. 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.

Anforderungen

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