FWPS_STREAM_CALLOUT_IO_PACKET0 構造体 (fwpsk.h)

[アーティクル]
08/07/2023

FWPS_STREAM_CALLOUT_IO_PACKET0構造体は、データストリームをフィルター処理するときに、フィルターエンジンによって吹き出しの classifyFn 吹き出し関数に渡されるデータを記述します。

FWPS_STREAM_CALLOUT_IO_PACKET0は特定のバージョンのFWPS_STREAM_CALLOUT_IO_PACKETであることに注意してください。詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象とする」を参照してください。

構文

typedef struct FWPS_STREAM_CALLOUT_IO_PACKET0_ {
  FWPS_STREAM_DATA0       *streamData;
  SIZE_T                  missedBytes;
  UINT32                  countBytesRequired;
  SIZE_T                  countBytesEnforced;
  FWPS_STREAM_ACTION_TYPE streamAction;
} FWPS_STREAM_CALLOUT_IO_PACKET0;

メンバー

streamData

引き出しドライバーの classifyFn 吹き出し関数で処理に使用できるデータストリームの部分を記述するFWPS_STREAM_DATA0構造体へのポインター。

missedBytes

コールアウトドライバーの classifyFn 吹き出し関数が最後に呼び出されてから見つからないデータストリーム内のバイト数。フィルターエンジンの重みが高いフィルターによって、引き出しドライバーの classifyFn 吹き出し関数がデータストリームの一部を処理できない場合、このメンバーは 0 以外です。

countBytesRequired

吹き出しの classifyFn 吹き出し関数によって設定される値。この値は、 streamAction メンバーを FWPS_STREAM_ACTION_NEED_MORE_DATA に設定する場合に、吹き出し関数に必要なストリームデータの追加バイト数を指定します。フィルターエンジンは、コールアウトドライバーの classifyFn 吹き出し関数を再度呼び出す前に、少なくともこの多数の追加バイトのストリームデータを受信するまで待機します。

吹き出しの classifyFn 吹き出し関数が streamAction メンバーを FWPS_STREAM_ACTION_NEED_MORE_DATA以外の値に設定する場合は、このメンバーを 0 に設定する必要があります。

countBytesEnforced

吹き出しの classifyFn 吹き出し関数によって設定される値。この値は、 streamAction メンバーまたは吹き出し関数によって返されるアクションによって指定されたアクションが適用される、処理されるデータストリームの部分のデータの先頭バイト数を指定します。ストリームバッファー内の残りのデータは、次にフィルターエンジンがコールアウトドライバーの classifyFn 吹き出し関数を呼び出すと、再び引き出しドライバーに渡されます。

streamAction

データストリームに適用するアクションを指定する吹き出しの classifyFn 吹き出し関数によって設定されるFWPS_STREAM_ACTION_TYPE値。このアクションは、吹き出し関数によって返されるアクションとは無関係です。吹き出しの classifyFn 吹き出し関数は、このメンバーを次のいずれかに設定します。

FWPS_STREAM_ACTION_NONE

ストリーム固有のアクションは必要ありません。

FWPS_STREAM_ACTION_ALLOW_CONNECTION

フローに属するすべての将来のデータセグメントが許可されることを示します。この場合、WFP はコールアウトへのデータセグメントの分類を停止し、それ以上検査オーバーヘッドが発生しないようにフローをハードウェアにオフロードしようとします。

FWPS_STREAM_ACTION_NEED_MORE_DATA

吹き出し関数では、さらに多くのストリームデータが必要です。

FWPS_STREAM_ACTION_DROP_CONNECTION

ストリーム接続を削除する必要があります。吹き出しの classifyFn 吹き出し関数は、フィルターエンジンが引き出しドライバーの classifyFn 吹き出し関数に渡したFWPS_FILTER0構造体の action.type メンバーに値FWP_ACTION_CALLOUT_UNKNOWNが含まれている場合にのみ、streamAction メンバーをこの値に設定する必要があります。吹き出しの classifyFn 吹き出し関数が、FWPS_FILTER0構造体の action.type メンバーにFWP_ACTION_CALLOUT_INSPECTION値が含まれている場合、streamAction メンバーをこの値に設定した場合、接続は削除されません。

FWPS_STREAM_ACTION_DEFER

ストリームデータの処理は、コールアウトドライバーが FwpsStreamContinue0 関数を呼び出すまで延期されます。このアクションは、受信データストリームに対してのみ設定できます。

受信データストリームを遅延すると、ネットワークスタックは送信者から受信したデータの確認を停止します。これにより、スライディング TCP ウィンドウのサイズが縮小されます。コールアウトドライバーは、この動作を使用してフロー制御を実装し、受信データレートを遅くできます。

FWPS_STREAM_ACTION_TYPE_MAX値は、テスト目的の最大値です。

吹き出しの classifyFn 吹き出し関数によってこのメンバー がFWPS_STREAM_ACTION_NONE以外の値に設定されている場合、吹き出し関数によって返されるアクションはフィルターエンジンによって無視されます。

注釈

フィルターエンジンは、データストリームをフィルター処理するときに、レイヤーData パラメーターとして引き出し線の classifyFn 吹き出し関数にFWPS_STREAM_CALLOUT_IO_PACKET0構造体へのポインターを渡します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降で使用できます。
Header	fwpsk.h (Fwpsk.h を含む)

こちらもご覧ください

次の方法で共有