FwpsNetBufferListAssociateContext0-Funktion (fwpsk.h)

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

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.

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

Siehe auch

FwpsNetBufferListAssociateContext1

NET_BUFFER_LIST

Verwenden von Pakettagging-