FwpsNetBufferListAssociateContext0-Funktion (fwpsk.h)

Artikel
03/01/2024

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

HinweisFwpsNetBufferListAssociateContext0 ist die spezifische Version von FwpsNetBufferListAssociateContext , die in Windows 7 und höher verwendet wird. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen . 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 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 willkürliche Kontextinformationen. Die Filter-Engine übergibt diesen Kontext an den Legendentreiber. FWPS_NET_BUFFER_LIST_NOTIFY_FN0.

[in] contextTag

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

providerGuid

Die Anbieter-GUID.

[in, out] deviceObject

Ein Zeiger auf das Geräteobjekt des Legendentreibers.

[in] notifyFn

Ein Zeiger auf den Legendentreiber FWPS_NET_BUFFER_LIST_NOTIFY_FN0-Funktion . Die Filter-Engine sendet status Benachrichtigungen 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 status Codes	Ein Fehler ist aufgetreten.

Hinweise

Die FwpsNetBufferListAssociateContext0-Funktion verknüpft Gruppen von Paketen mit dem Legendentreiber. Pakete von Interesse können zur Überprüfung über mehrere Schichten im Stapel nachverfolgt werden.

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

Anforderungen

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

Weitere Informationen

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Verwenden von Pakettagging

Freigeben über