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 吹き出し関数を実装しないでください。 このような状況では、コールアウト ドライバーは、次の値を設定する必要があります。
flowDeleteFn FWPS_CALLOUT0 構造体のメンバー、フィルター エンジンにコールアウトを登録するときに NULL を します。
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0型は、次のように flowDeleteFn 関数へのポインターとして定義されます。
typedef void (NTAPI *FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0) flowDeleteFn
フィルター エンジンは、IRQL <= DISPATCH_LEVEL で吹き出しの flowDeleteFn 吹き出し関数を呼び出します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降で使用できます。 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | fwpsk.h (Fwpsk.h を含む) |
| IRQL | <= DISPATCH_LEVEL |