FwpsNetBufferListRemoveContext0-Funktion (fwpsk.h)

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

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 Für den Popuptreiber interessantes Paket angibt. Dieser Parameter ist optional und kann NULL-werden. Wenn es NULL-ist, entfernt die Funktion den Kontext aus allen zugeordneten Netzwerkpufferlisten.

[in] contextTag

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

[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.

Bemerkungen

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

Um einen Kontext einer Netzwerkpufferliste zuzuordnen, rufen Sie auf FwpsNetBufferListAssociateContext0 oder FwpsNetBufferListAssociateContext1.

In der Regel muss kein Beschriftungstreiber diese Funktion verwenden, da der markierte Kontext automatisch entfernt wird, wenn die Pakete durch den Stapel navigieren. Diese Funktion wird bereitgestellt, damit ein Popuptreiber die Verarbeitung in Situationen beenden kann, in denen Kontexte nicht automatisch entfernt werden. Bei einem NDIS-Filtertreiber geben die Pakete beispielsweise niemals den TCP/IP-Stapel ein, und die Kontexte müssen manuell entfernt werden, indem FwpsNetBufferListRemoveContext0 mit dem netBufferList Parameter aufgerufen werden, der auf NULL-festgelegt ist.

Anforderungen

Siehe auch

FwpsNetBufferListAssociateContext1

NET_BUFFER_LIST

Verwenden von Pakettagging-