FwpsNetBufferListRemoveContext0 関数 (fwpsk.h)

  • [アーティクル]

FwpsNetBufferListRemoveContext0 関数は、ネットワーク バッファー リストに関連付けられているコンテキストを削除します。

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

構文

NTSTATUS FwpsNetBufferListRemoveContext0(
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in]                UINT64          contextTag,
  [in]                UINT32          flags
);

パラメーター

[in, out, optional] netBufferList

吹き出しドライバーに関心のある 1 つ以上のパケットを示すネットワーク バッファーの一覧。 このパラメーターは省略可能であり、 NULL にすることができます。 NULL の場合、関数は関連付けられているすべてのネットワーク バッファー リストからコンテキストを削除します。

[in] contextTag

contextTag パラメーターで FwpsNetBufferListAssociateContext0 に渡されたコンテキスト タグ。

[in] flags

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

戻り値

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

リターン コード 説明
STATUS_SUCCESS
 コンテキストが正常に削除されました。
その他の状態コード
 エラーが発生しました。

解説

FwpsNetBufferListRemoveContext0 関数は、ネットワーク バッファー リストに関連付けられているタグ付きコンテキストを非同期的に削除します。

コンテキストをネットワーク バッファー リストに関連付けるには、 を呼び出します。 FwpsNetBufferListAssociateContext0 または FwpsNetBufferListAssociateContext1。

タグ付けされたコンテキストはパケットがスタック内を移動すると自動的に削除されるため、通常、吹き出しドライバーはこの関数を使用する必要はありません。 この関数は、コンテキストが自動的に削除されない状況でコールアウト ドライバーが処理を停止できるように提供されます。 たとえば、NDIS フィルター ドライバーの場合、パケットは TCP/IP スタックに入ることはありません。netBufferList パラメーターを NULL に設定して FwpsNetBufferListRemoveContext0 を呼び出すことによって、コンテキストを手動で削除する必要があります。

要件

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

こちらもご覧ください

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

パケット タグ付けの使用