次の方法で共有

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

  • [アーティクル]

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

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

 

構文

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 コードを返します。

リターン コード 形容
STATUS_SUCCESS
 吹き出しドライバーは、フィルター エンジンからの通知を受け入れます。
その他の状態コードの
 エラーが発生しました。

備考

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

この関数は FWPS_NET_BUFFER_LIST_NOTIFY_FN0と同じですが、戻り値の型が VOID ではなく NTSTATUS 点が異なります。

必要条件

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

関連項目

コールアウト ドライバーの吹き出し関数の

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

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