FwpsNetBufferListAssociateContext1 関数 (fwpsk.h)

[アーティクル]
08/07/2023

FwpsNetBufferListAssociateContext1 関数は、吹き出しドライバーのコンテキストをネットワークバッファーリストに関連付け、ネットワークバッファーリストイベントの通知を構成します。

メモFwpsNetBufferListAssociateContext1 は、Windows 8 以降で使用される FwpsNetBufferListAssociateContext の特定のバージョンです。詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象とする」を参照してください。 Windows 7 の場合、 FwpsNetBufferListAssociateContext0 を使用できます。

構文

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
);

パラメーター

[in, out] netBufferList

吹き出しドライバーに関心のある 1 つ以上のパケットを示すネットワークバッファーの一覧。

[in] layerId

コンテキストが関連付けられているレイヤーの識別子。 NDIS 受信パスからこの関数を呼び出す場合は、このパラメーターを FWPS_LAYER_NON_WFP に設定します。

[in] context

吹き出しドライバーによって設定された任意のコンテキスト情報。フィルターエンジンは、このコンテキストを引き出しドライバーのに渡します。
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 関数。

[in] contextTag

を呼び出して取得したローカル一意識別子 FwpsNetBufferListGetTagForContext0 関数。

providerGuid

プロバイダー GUID。

[in, out] deviceObject

引き出しドライバーのデバイスオブジェクトへのポインター。

[in] notifyFn

引き出しドライバーの FWPS_NET_BUFFER_LIST_NOTIFY_FN1 関数へのポインター。フィルターエンジンは、この関数に状態通知を送信します。

[in] flags

このパラメーターは、今後使用するために予約されており、0 に設定されます。

戻り値

FwpsNetBufferListAssociateContext1 関数は、次の NTSTATUS コードのいずれかを返します。

リターンコード	説明
STATUS_SUCCESS	関連付けが成功しました。
その他の状態コード	エラーが発生しました。

解説

FwpsNetBufferListAssociateContext1 関数は、パケットのグループを吹き出しドライバーに関連付けます。関心のあるパケットは、スタック内の複数のレイヤーを介した検査のために追跡できます。

この関数を呼び出す前に、 FwpsNetBufferListGetTagForContext0 関数を呼び出してコンテキストタグを取得する必要があります。

この関数は、基本的に以前のバージョンと同じです。

FwpsNetBufferListAssociateContext0。唯一の違いは、notifyFn パラメーターによって指FWPS_NET_BUFFER_LIST_NOTIFY_FN1更新された関数です。

要件

要件	値
サポートされている最小のクライアント	Windows 8以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	fwpsk.h (Fwpsk.h を含む)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL