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

フィルター エンジンは、吹き出しの flowDeleteFn 吹き出し関数を呼び出して、吹き出しによって処理されているデータ フローが終了していることを吹き出しに通知します。

構文

FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 FwpsCalloutFlowDeleteNotifyFn0;

void FwpsCalloutFlowDeleteNotifyFn0(
  [in] UINT16 layerId,
  [in] UINT32 calloutId,
  [in] UINT64 flowContext
)
{...}

パラメーター

[in] layerId

データ フローが終了するフィルターレイヤーの実行時識別子。 詳細については、「 ランタイム フィルター レイヤー識別子」を参照してください。

[in] calloutId

フィルター エンジン内の吹き出しの実行時識別子。 これは、引き出し線をフィルター エンジンに登録するために FwpsCalloutRegister0 関数または FwpsCalloutRegister1 関数を呼び出したときに返された識別子と同じです。

[in] flowContext

FwpsFlowAssociateContext0 関数の呼び出しによってデータ フローに関連付けられた最新のコンテキスト。

戻り値

なし

解説

吹き出しドライバーは、 FwpsCalloutRegister0 または FwpsCalloutRegister1 関数を呼び出すことによって、吹き出しの吹き出し関数をフィルター エンジンに登録します。

フィルター エンジンは、データ フローを終了したときに吹き出しの flowDeleteFn 吹き出し関数を呼び出し、吹き出しがデータ フローに関連付けられているコンテキストをクリーンできるようにします。 たとえば、この吹き出し関数は、最初に classifyFn が呼び出されずに、RST から突然停止した後に呼び出されます。 フィルター エンジンは、吹き出しドライバーがデータ フローにコンテキストを関連付ける場合にのみ、この引き出し関数を呼び出します。 データ フローが終了すると、フィルター エンジンによってデータ フローからコンテキストが自動的に削除されます。

フィルター エンジンは、吹き出しの flowDeleteFn 吹き出し関数を呼び出します。これは、データ フローをサポートするフィルター レイヤーで吹き出しがフィルター エンジンに以前に追加され、吹き出しドライバーがコンテキストを処理するデータ フローに関連付ける場合にのみ行われます。 引き出し線ドライバーは、引き出し線が処理するデータ フローにコンテキストを関連付けなければ、引き出し線の flowDeleteFn 吹き出し関数を実装しないでください。 このような状況では、引き出しドライバーは、 を設定する必要があります。
吹き出しをフィルター エンジンに登録するときに、FWPS_CALLOUT0構造体の flowDeleteFn メンバーを NULL に設定します。

FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0型は、 flowDeleteFn 関数へのポインターとして次のように定義されます。

typedef void (NTAPI *FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0) flowDeleteFn

フィルター エンジンは、IRQL <= DISPATCH_LEVEL で吹き出しの flowDeleteFn 吹き出し関数を呼び出します。

要件

こちらもご覧ください

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

FWPS_CALLOUT0

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0