FwpsNetBufferListRemoveContext0-Funktion (fwpsk.h)

Artikel
08/07/2023

Die FwpsNetBufferListRemoveContext0-Funktion entfernt den Kontext, der einer Netzwerkpufferliste zugeordnet ist.

HinweisFwpsNetBufferListRemoveContext0 ist eine bestimmte Version von FwpsNetBufferListRemoveContext. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .

Syntax

NTSTATUS FwpsNetBufferListRemoveContext0(
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in]                UINT64          contextTag,
  [in]                UINT32          flags
);

Parameter

[in, out, optional] netBufferList

Eine Netzwerkpufferliste, die mindestens ein Paket angibt, das für den Legendentreiber von Interesse ist. Dieser Parameter ist optional und kann NULL sein. Wenn sie NULL ist, entfernt die Funktion den Kontext aus allen zugeordneten Netzwerkpufferlisten.

[in] contextTag

Das Kontexttag, das im contextTag-Parameter an FwpsNetBufferListAssociateContext0 übergeben wurde.

[in] flags

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss null sein.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Kontext wurde erfolgreich entfernt.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Die Funktion FwpsNetBufferListRemoveContext0 entfernt asynchron den getaggten Kontext, der einer Netzwerkpufferliste zugeordnet ist.

Rufen Sie auf, um einen Kontext einer Netzwerkpufferliste zuzuordnen. FwpsNetBufferListAssociateContext0 oder FwpsNetBufferListAssociateContext1.

In der Regel muss ein Legendentreiber diese Funktion nicht verwenden, da der markierte Kontext automatisch entfernt wird, wenn sich die Pakete durch den Stapel bewegen. Diese Funktion wird bereitgestellt, damit ein Legendentreiber die Verarbeitung in Situationen beenden kann, in denen Kontexte nicht automatisch entfernt werden. Im Fall eines NDIS-Filtertreibers gelangen die Pakete beispielsweise nie in den TCP/IP-Stapel, und die Kontexte müssen manuell entfernt werden, indem FwpsNetBufferListRemoveContext0 aufgerufen wird, wobei der netBufferList-Parameter auf NULL festgelegt ist.

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

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Verwenden von Pakettagging

Freigeben über