次の方法で共有

FwpsNetBufferListRetrieveContext0 関数 (fwpsk.h)

  • [アーティクル]

FwpsNetBufferListRetrieveContext0 関数は、別のレイヤーでタグ付けされたネットワーク バッファー リストに関連付けられたコンテキストを取得します。

注意FwpsNetBufferListRetrieveContext0 は、FwpsNetBufferListRetrieveContextの特定のバージョンです。 詳細については、「WFP Version-Independent 名の と Windows の特定のバージョンを対象とする」を参照してください。
 

構文

NTSTATUS FwpsNetBufferListRetrieveContext0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      UINT64          contextTag,
  [in]      BOOLEAN         removeContext,
  [in]      UINT32          flags,
  [out]     UINT64          *context
);

パラメーター

[in, out] netBufferList

吹き出しドライバーに関心のある 1 つ以上のパケットを示すネットワーク バッファーの一覧。 removeContext 設定されている場合、返されるネットワーク バッファー リストはコンテキストを削除します。

[in] contextTag

を呼び出して取得したローカル一意識別子FwpsNetBufferListGetTagForContext0 関数を します。 これは、FwpsNetBufferListAssociateContext0 をする最初の呼び出しで使用されるコンテキスト タグです。

[in] removeContext

設定すると、FwpsNetBufferListRetrieveContext0 コンテキストの取得に加えて、コンテキストの関連付けが削除されます。

[in] flags

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

[out] context

FwpsNetBufferListAssociateContext0 への初期呼び出しでコールアウト ドライバーによってパケットに割り当てられたコンテキスト。

戻り値

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

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

備考

FwpsNetBufferListRetrieveContext0 関数は、別のレイヤーでタグ付けされたネットワーク バッファー リストを取得します。

この関数を使用して、removeContext パラメーターを設定してコンテキストの関連付けを削除することもできます。

必要条件

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

関連項目

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST