FwpsNetBufferListAssociateContext1-Funktion (fwpsk.h)

Artikel
02/29/2024

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

HinweisFwpsNetBufferListAssociateContext1 ist die spezifische Version von FwpsNetBufferListAssociateContext, 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 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 Paket angibt, das für den Legendentreiber von Interesse ist.

[in] layerId

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

[in] context

Vom Legendentreiber festgelegte beliebige Kontextinformationen. Die Filter-Engine übergibt diesen Kontext an den Beschriftungstreiber.
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 Legendentreibers.

[in] notifyFn

Ein Zeiger auf die FWPS_NET_BUFFER_LIST_NOTIFY_FN1-Funktion des Legendentreibers. Die Filter-Engine sendet status Benachrichtigungen an diese Funktion.

[in] flags

Dieser Parameter ist für die zukünftige Verwendung reserviert und auf 0 (null) festgelegt.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Verein war erfolgreich.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Die Funktion FwpsNetBufferListAssociateContext1 ordnet dem Legendentreiber Paketgruppen zu. Interessante Pakete können zur Überprüfung über mehrere Ebenen im Stapel nachverfolgt werden.

Vor dem Aufrufen dieser Funktion muss die Funktion FwpsNetBufferListGetTagForContext0 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 der notifyFn-Parameter verweist.

Anforderungen

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

Weitere Informationen

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Verwenden von Pakettagging

Freigeben über