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

[アーティクル]
02/26/2024

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

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

構文

FWPS_NET_BUFFER_LIST_NOTIFY_FN0 FwpsNetBufferListNotifyFn0;

void FwpsNetBufferListNotifyFn0(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out, optional] 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, optional] netBufferList

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

[in, out, optional] newNetBufferList

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

[in] layerId

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

[in] context

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

[in] contextTag

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

戻り値

なし

解説

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

要件

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