次の方法で共有

FwpsNetBufferListAssociateContext0 関数 (fwpsk.h)

  • [アーティクル]

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

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

構文

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

パラメーター

[in, out] netBufferList

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

[in] layerId

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

[in] context

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

[in] contextTag

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

providerGuid

プロバイダー GUID。

[in, out] deviceObject

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

[in] notifyFn

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

[in] flags

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

戻り値

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

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

備考

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

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

必要条件

要件 価値
サポートされる最小クライアント Windows 7 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー fwpsk.h (Fwpsk.h を含む)
ライブラリ Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

関連項目

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

パケット タグ付け を使用した