パケット挿入関数

[アーティクル]
04/04/2024

コールアウトドライバーは、次の WFP 関数を呼び出して、保留中または変更されたパケットデータを TCP/IP スタックに挿入できます。次の表に、データを挿入できる適用可能なレイヤーと、考えられる宛先を示します。

挿入関数	適用可能なレイヤー	宛先
FwpsInjectForwardAsync0	ネットワーク層	転送データパス
FwpsInjectNetworkReceiveAsync0	ネットワーク層	受信データパス
FwpsInjectNetworkSendAsync0	ネットワーク層	送信データパス
FwpsInjectTransportReceiveAsync0	トランスポート、データグラムデータ、ICMP エラー、または ALE レイヤーからのパケットデータ	受信データパス
FwpsInjectTransportSendAsync0	トランスポート、データグラムデータ、ICMP エラー、または ALE レイヤーからのパケットデータ	送信データパス
FwpsStreamInjectAsync0	TCP データセグメント	データストリーム

さらに、FwpsQueryPacketInjectionState0 関数は、パケットデータの挿入履歴を検査するために使用されます。

クロスレイヤー挿入は、コールアウトが挿入関数に必要なすべての必要な情報を提供でき、ネットバッファーリストが挿入関数で予期される形式を持つ場合に有効になります。たとえば、コールアウトでは、転送パスでパケットをキャプチャし、その宛先アドレスをローカルコンピューターのアドレスに変更し、FwpsInjectTransportReceiveAsync0 を呼び出して、パケットをローカルコンピューターの TCP/IP スタックにリダイレクトできます。

ストリーム (TCP データ) 挿入を除き、挿入された受信パケットはスタックと WFP レイヤーの「下部」から再入力され、挿入された送信パケットはスタックレイヤーと WFP レイヤーの「上部」から再入力されます。たとえば、受信データグラムデータ層から挿入された UDP パケットは、スタックに再入し、ネットワーク層、トランスポート層、ALE 受信層または受け入れ層 (省略可能) を走査し、データグラムデータ層に戻ります。送信ネットワーク層から挿入された別の UDP パケットは、スタックに再入し、ALE (省略可能)、データグラムデータ、およびトランスポート層を走査し、ネットワークレイヤーに戻ります。

FwpsInjectTransportReceiveAsync0 は、以前に IPsec 検証を行っていたため、再挿入されたパケットの IPsec 処理を自動的にバイパスします。

WFP コールアウトドライバーによって挿入されたパケットは、パケットの変更によって元のフィルター条件を満たさなくなる場合を除き、コールアウトに再び示されます。 WFP は、コールアウトによってパケットが挿入された (または以前に挿入された) かどうかを照会するコールアウト用の FwpsQueryPacketInjectionState0 関数を提供します。無限ループを防ぐには、コールアウトで自己挿入パケットを許可する必要があります。

コールアウトでは、IP パケットを変更した後、IP またはトランスポート層チェックサムまたは両方を調整する必要があります。 IPv4 パケット経由の UDP では、コールアウトでチェックサムを 0 に設定できます。トランスポート層チェックサムオフロードと互換性があり、それに応じて完全なチェックサムと擬似チェックサムの計算を調整するには、コールアウトで次のロジックを使用できます。

NDIS_TCP_IP_CHECKSUM_PACKET_INFO ChecksumInfo;
 ChecksumInfo.Value = 
 (ULONG) (ULONG_PTR)NET_BUFFER_LIST_INFO(
 NetBufferList,TcpIpChecksumNetBufferListInfo);

If ChecksumInfo.Transmit.NdisPacketTcpChecksum が TRUE の場合、TCP 送信操作はオフロードされます。 If ChecksumInfo.Transmit.NdisPacketUdpChecksum が TRUE の場合、UDP 送信操作はオフロードされます。

Windows Vista Service Pack 1 (SP1) および Windows Server 2008 では、inMetaValues->headerIncludeHeaderLength が 0 より大きい場合、送信パケットは IP ヘッダーを含む RAW 送信の再挿入です。 Windows Vista SP1 および Windows Server 2008 で IP ヘッダーを含む RAW 送信の再挿入を実行するには、inMetaValues->headerIncludeHeaderLength 内の量で複製されたパケットを退避し、新しく拡張された領域に inMetaValues->headerIncludeHeader をコピーする必要があります。次に、パケットのネットバッファーリストと共に FwpsInjectTransportSendAsync0 を使用し、FWPS_TRANSPORT_SEND_PARAMS0 パラメーターを NULL に設定したままにしておきます。ネットバッファーリストの退避操作の詳細については、「退避操作と事前操作」を参照してください。

注: 生の送信操作の場合、ネットバッファーリストには 1 つのネットバッファーのみを含める必要があります。ネットバッファーリストに複数のネットバッファーが含まれている場合は、ネットバッファーリストを一連のネットバッファーリストに変換する必要があり、各シリーズ内に 1 つのネットバッファーが含まれている必要があります。ネットバッファーリスト管理の詳細については、「NET_BUFFER アーキテクチャ」を参照してください。

次の方法で共有

パケット挿入関数

フィードバック

その他のリソース