FWPS_NET_BUFFER_LIST_NOTIFY_FN1 コールバック関数 (fwpsk.h)

フィルター エンジンは 、吹 き出しによってタグ付けされたパケットに関連付けられているイベントについてコールアウト ドライバーに通知するために、FWPS_NET_BUFFER_LIST_NOTIFY_FN1吹き出し関数を呼び出します。

構文

FWPS_NET_BUFFER_LIST_NOTIFY_FN1 FwpsNetBufferListNotifyFn1;

NTSTATUS FwpsNetBufferListNotifyFn1(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out]           NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

パラメーター

[in] eventType

フィルター エンジンが吹き出しに送信する通知の種類を示す 値。 このパラメーターは、 の値のいずれかに設定されます。 列挙FWPS_NET_BUFFER_LIST_EVENT_TYPE0 。

[in, out] netBufferList

以前にコールアウト ドライバーによって興味深いタグが付けられていたパケットを含むバッファー リストへのポインター。

[in, out, optional] newNetBufferList

コールアウト ドライバーに関心のあるパケットを含む更新されたバッファー リストへのポインター。 このパラメーターの使用は、イベントの種類によって異なります。 指定されたパケットに変更が加えられたイベントの場合、変更されたバージョンがこのパラメーターとして渡されます。

[in] layerId

通知関数の呼び出し元レイヤー。

[in] context

目的のパケットにタグを付けるために使用されるコンテキスト。 この値は、コールアウト ドライバーによってパケットに割り当てられた値であり、パケットを識別するために使用されます。

[in] contextTag

目的のパケットをコールアウト ドライバーのコンテキストに関連付けるために使用されるコンテキスト タグ。

戻り値

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

解説

この関数は、 FwpsNetBufferListAssociateContext1 の呼び出しによってコールアウト ドライバーに関連付けられます。 コールアウト ドライバーは、1 つの通知関数を使用して、コンテキストとコンテキスト タグを使用してインスタンスを区別することで、複数の関連付けられたバッファー リストのメッセージを処理できます。

この関数は、戻り値の型が VOID ではなく NTSTATUS である点を除き、FWPS_NET_BUFFER_LIST_NOTIFY_FN0と同じです。

要件

こちらもご覧ください

引き出し線ドライバーの吹き出し関数

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

パケット タグ付けの使用