FwpsNetBufferListAssociateContext1-Funktion (fwpsk.h)

Artikel
02/07/2025

Die FwpsNetBufferListAssociateContext1 Funktion ordnet den Kontext des Popuptreibers einer Netzwerkpufferliste zu und konfiguriert Benachrichtigungen für Netzwerkpufferlistenereignisse.

HinweisFwpsNetBufferListAssociateContext1 ist die spezifische Version von FwpsNetBufferListAssociateContext in Windows 8 und höher verwendet. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und zielspezifische Versionen von Windows. Für Windows 7 ist FwpsNetBufferListAssociateContext0- verfügbar.

Syntax

NTSTATUS FwpsNetBufferListAssociateContext1(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
  [in]      UINT32                          flags
);

Parameter

[in, out] netBufferList

Eine Netzwerkpufferliste, die mindestens ein Für den Popuptreiber interessantes Paket angibt.

[in] layerId

Der Bezeichner der Ebene, in der der Kontext zugeordnet wird. Wenn Sie diese Funktion aus dem NDIS-Empfangspfad aufrufen, legen Sie diesen Parameter auf FWPS_LAYER_NON_WFPfest.

[in] context

Beliebige Kontextinformationen, die vom Legendentreiber festgelegt werden. Das Filtermodul übergibt diesen Kontext an den Legendentreiber.
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 Funktion.

[in] contextTag

Ein lokal eindeutiger Bezeichner, der durch Aufrufen der FwpsNetBufferListGetTagForContext0 Funktion.

providerGuid

Die Anbieter-GUID.

[in, out] deviceObject

Ein Zeiger auf das Geräteobjekt des Popuptreibers.

[in] notifyFn

Ein Zeiger auf die FWPS_NET_BUFFER_LIST_NOTIFY_FN1 Funktion des Popuptreibers. Das Filtermodul sendet Statusbenachrichtigungen an diese Funktion.

[in] flags

Dieser Parameter ist für die zukünftige Verwendung reserviert und auf Null festgelegt.

Rückgabewert

Die FwpsNetBufferListAssociateContext1--Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Zuordnung war erfolgreich.
Andere Statuscodes	Fehler.

Bemerkungen

Die FwpsNetBufferListAssociateContext1- Funktion ordnet Gruppen von Paketen dem Popuptreiber zu. Interessante Pakete können für die Überprüfung über mehrere Ebenen im Stapel nachverfolgt werden.

Vor dem Aufrufen dieser Funktion muss die FwpsNetBufferListGetTagForContext0--Funktion aufgerufen werden, um ein Kontexttag abzurufen.

Diese Funktion ist im Wesentlichen mit der vorherigen Version identisch,

FwpsNetBufferListAssociateContext0. Der einzige Unterschied ist die aktualisierte FWPS_NET_BUFFER_LIST_NOTIFY_FN1 Funktion, auf die die notifyFn Parameter verweist.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 8.
Zielplattform-	Universal
Header-	fwpsk.h (include Fwpsk.h)
Library	Fwpkclnt.lib
IRQL-	<= DISPATCH_LEVEL

Siehe auch

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Verwenden von Pakettagging-

Freigeben über