TCP_OFFLOAD_STATE_CONST 構造体 (ndischimney.h)

[アーティクル]
02/29/2024

[TCP チムニーオフロード機能は非推奨であり、使用しないでください。]

TCP_OFFLOAD_STATE_CONST構造体には、TCP 接続状態オブジェクトの定数変数が含まれています。

構文

typedef struct _TCP_OFFLOAD_STATE_CONST {
  OFFLOAD_STATE_HEADER Header;
  USHORT               Flags;
  USHORT               RemotePort;
  USHORT               LocalPort;
  UCHAR                SndWindScale : 4;
  UCHAR                RcvWindScale : 4;
  USHORT               RemoteMss;
  ULONG                HashValue;
} TCP_OFFLOAD_STATE_CONST, *PTCP_OFFLOAD_STATE_CONST;

メンバー

Header

OFFLOAD_STATE_HEADER構造体。 NDIS は、ヘッダーの Length メンバーを、TCP_OFFLOAD_STATE_CONST構造体のサイズ (バイト単位) に設定します。 Header の RecognizedOptions メンバーは予約されています。

Flags

0 または次のいずれかのフラグをビットごとの OR と組み合わせて設定できるビットマスク。

TCP_FLAG_TIMESTAMP_ENABLED

ホストスタックは、このフラグを設定して、接続で TCP タイムスタンプオプションを有効にします。 (TCP タイムスタンプオプションの詳細については、「RFC 1323」を参照してください)。このオプションを有効にすると、オフロードターゲットは、送信する各 TCP セグメントにタイムスタンプを配置する必要があります。ホストスタックはこのフラグをクリアして、接続の TCP タイムスタンプオプションを無効にします。

TCP_FLAG_SACK_ENABLED

ホストスタックは、接続で選択的受信確認 (SACK) を有効にするようにこのフラグを設定します。 (SACK の詳細については、RFC 2018 を参照してください)。このオプションを有効にすると、オフロードターゲットは TCP 接続経由で SACK ブロックを送受信します。ホストスタックは、接続で SACK を無効にするためにこのフラグをクリアします。

TCP_FLAG_WINDOW_SCALING_ENABLED

ホストスタックは、オフロードターゲットがスケールファクター (SndWindScale と RcvWindScale) を使用して接続の送受信ウィンドウを計算するように、このフラグを設定します。 (ウィンドウスケールファクターの詳細については、「RFC 2883 および 3517」を参照してください)。ホストスタックはこのフラグをクリアして、このオプションを無効にします。

RemotePort

宛先ポート番号 (RFC 793 を参照)。

LocalPort

ソースポート番号 (RFC 793 を参照)。

SndWindScale

送信ウィンドウのスケールファクター (RFC 1323 を参照)。

RcvWindScale

受信ウィンドウのスケールファクター (RFC 1323 を参照)。

RemoteMss

TCP 接続のセットアップ中にリモートエンドポイントによってアドバタイズされる初期最大セグメントサイズ (MSS)。 (MSS の詳細については、RFC 2581 を参照してください)。

HashValue

オフロードターゲットが RSS をサポートしている場合に TCP 接続での受信側スケーリング (RSS) 処理にオフロードターゲットが使用する 32 ビットハッシュ値。

注釈

各 TCP 定数変数の値は、TCP 接続の有効期間中は変更されません。ホストスタックとオフロードターゲットのどちらも、TCP 定数変数の値を変更しません。ホストスタックが TCP 接続状態オブジェクトのオフロードを終了するとき、NDIS がオフロードターゲットのを呼び出すようにします。 MiniportTerminateOffload 関数では、オフロードターゲットは、オフロードされた TCP 定数変数の値をホストスタックに返しません。

オフロードターゲットに渡されると、TCP_OFFLOAD_STATE_CONST構造体はに関連付けられます。 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 構造体。 NDIS_OBJECT_HEADER構造体として書式設定されたヘッダーが含まれます。この場合、NDIS_OBJECT_HEADER構造体の Revision メンバーは、TCP_OFFLOAD_STATE_CONST構造体のリビジョン番号を指定します。