FwpsNetBufferListAssociateContext1-Funktion (fwpsk.h)

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

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

[in] context

Beliebige Kontextinformationen, die vom Legendentreiber festgelegt werden. Das Filtermodul übergibt diesen Kontext an den Legendentreiber.
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 Popuptreibers.

[in] notifyFn

Ein Zeiger auf die FWPS_NET_BUFFER_LIST_NOTIFY_FN1 Funktion des Popuptreibers. 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 FwpsNetBufferListAssociateContext1--Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Bemerkungen

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

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 die notifyFn Parameter verweist.

Anforderungen

Siehe auch

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

NET_BUFFER_LIST

Verwenden von Pakettagging-