FwpsNetBufferListAssociateContext0-Funktion (fwpsk.h)

Artikel
02/07/2025

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

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

Syntax

NTSTATUS FwpsNetBufferListAssociateContext0(
  [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_FN0 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_WFP fest.

[in] context

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

[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 Legendentreiber FWPS_NET_BUFFER_LIST_NOTIFY_FN0 Funktion. 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 FwpsNetBufferListAssociateContext0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

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

Bemerkungen

Die FwpsNetBufferListAssociateContext0-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.

Anforderungen

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

Siehe auch

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Verwenden von Pakettagging-

Freigeben über