NDIS_TCP_OFFLOAD_EVENT_INDICATE コールバック関数 (ndischimney.h)

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

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

オフロードターゲットは NdisTcpOffloadEventHandler 関数を呼び出して、オフロードされた TCP 接続に関連するイベントを示します。

構文

NDIS_TCP_OFFLOAD_EVENT_INDICATE NdisTcpOffloadEventIndicate;

void NdisTcpOffloadEventIndicate(
  [in] IN NDIS_HANDLE NdisOffloadHandle,
  [in] IN ULONG EventType,
  [in] IN ULONG EventSpecificInformation
)
{...}

パラメーター

[in] NdisOffloadHandle

指示が行われているオフロードされた TCP 接続を識別するハンドル。接続がオフロードされたとき、このハンドルはの NdisOffloadHandle メンバーで指定されました。 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 接続状態に関連付けられた構造体です。

[in] EventType

次のいずれかの TCP_OFFLOAD_EVENT_TYPE 値として示されているイベント。

TcpIndicateDisconnect

接続で FIN セグメントを送信することによって、リモートホストが正常な切断を開始したことを示します。

TcpIndicateRetrieve

オフロードターゲットが TCP 接続のオフロードを終了するようにホストスタックに要求していることを示します。

TcpIndicateAbort

接続で許容可能な RST セグメントを送信することによって、リモートホストが中止切断を開始したことを示します。

TcpIndicateSendBacklogChange

優先する送信バックログサイズの変更を示します。

[in] EventSpecificInformation

次のように示されているイベントに関する追加情報を指定します。

TcpIndicateDisconnect

意味がありません。

TcpIndicateRetrieve

アップロード要求の理由を TCP_UPLOAD_REASON 値として示します。詳細については、次の「解説」を参照してください。

TcpIndicateAbort

意味がありません。

TcpIndicateSendBacklogChange

ホストスタックがオフロードターゲットで未処理にする必要がある送信データバイトの最適な数を指定します。

戻り値

なし

解説

正常な切断を示す

オフロードターゲットは、次の場合にのみ正常な切断を示す必要があります。

リモートホストから FIN セグメントを受信しました。
FIN セグメントの受信前に接続で受信されたすべてのデータは、クライアントアプリケーションによって使用されています (つまり、接続で示される受信データはありません)。

オフロードターゲットは、ホストスタックが接続のオフロードを終了するまで、接続のリソースを解放することはできません。

正常な切断では、接続の受信半分のみがシャットダウンされることに注意してください。接続の送信の半分はシャットダウンされません。

切断の中止を示す

オフロードターゲットが TCP 接続で許容可能な RST セグメントを受信する場合は、次の手順を実行する必要があります。

接続の内部状態で、接続を中止済みとしてマークします。
EventType が TcpIndicateAbort の NdisTcpOffloadEventHandler 関数を呼び出します。
メモミニポートが TcpIndicateAbort イベントを示すと、ホスト TCP/IP スタックは接続のオフロードを終了します。オフロードターゲットは、RST セグメントが到着するとすぐに TcpIndicateAbort イベントを示す自由です。
NDIS_STATUS_REQUEST_ABORTEDを使用して、接続で未処理のすべての送信要求と切断要求を完了します。オフロードターゲットは、リンクされたリスト内の各NET_BUFFER_LIST構造体の Status メンバーにこの状態値を書き込みます。 NdisTcpOffloadSendComplete 関数または NdisTcpOffloadDisconnectComplete 関数。

オフロードターゲットは、ホストスタックが接続のオフロードを終了するまで、接続のリソースを解放することはできません。

TCP 接続の終了の要求

オフロードターゲットは、終了要求の理由を、NdisTcpOffloadEventHandler 関数に渡す EventSpecificInformation パラメーターのTCP_UPLOAD_REASON値として指定します。応答として、ホストスタックはオフロードターゲットの MiniportTerminateOffload 関数を呼び出します。

オフロードターゲットは、 NdisTcpOffloadEventHandler の呼び出しごとに 1 つの TCP 接続の終了のみを要求できます。オフロードターゲットは、近隣状態オブジェクトまたはパス状態オブジェクトの終了を要求できません。ホストスタックのみが近隣オブジェクトまたはパス状態オブジェクトの終了を開始できます。

次の表では、オフロードターゲットが TCP 接続のオフロードの終了を要求する可能性があるイベントまたは状況について説明します。

右端の列は、各 TCP_UPLOAD_REASONについて、ホストスタックが常に接続をアップロードするか (必須)、または接続をアップロードしない可能性があるか (省略可能) かを示します。必須の場合、オフロードターゲットはオフロードされた接続の処理を続行しません。オプションの場合、オフロードターゲットは、ホストスタックがその接続のオフロードを終了しない場合、オフロードされた接続で処理を続行できる必要があります。

イベント/状況	TCP_UPLOAD_REASON	ホストスタックによる TCP 接続の終了
接続の追跡に使用されるハードウェアの状態が破損しています。	HardwareFailure	Mandatory
オフロードターゲットは、無効な状態オブジェクトに依存する TCP 接続でデータを送信しようとしました。	InvalidState	Mandatory
オフロードターゲットは、TCP ヘッダーに URG ビットが設定されたセグメントを受け取ります。オフロードターゲットは緊急データを確認するために ACK を送信しないことに注意してください。	ReceivedUrgentData	Mandatory
TCP 接続でタイムアウトが発生しました。	TimeoutExpiration	Mandatory
オフロードターゲットは、未指定の理由でアップロードを要求しています。	UploadRequested	Mandatory
オフロードターゲットは、TCP 接続で削除されている送信セグメントが多すぎることを検出しました。	HighDropRate	オプション
オフロードターゲットは、TCP 接続で受信されているフラグメントが多すぎることを検出しました。	HighFragmentation	オプション
オフロードターゲットが TCP 接続で受信した順序が異なっているセグメントが多すぎます。	HighOutofOrderPackets	オプション
TCP 接続のアクティビティ (送受信) が低すぎます。	LowActivity	オプション
TCP 接続用の事前にポストされた受信バッファーはありません。	NoBufferProposting	オプション
TCP 接続用にポストされた受信バッファーが小さすぎます。	SmallIO	オプション

オフロードターゲットは、その接続が次のいずれかの状態にある場合に、ハーフクローズ TCP 接続の終了を開始することはできません。

FIN_WAIT1--ローカルホストスタックは TCP 接続を閉じていますが、接続がリモートエンドポイントからデータを受信している可能性があります。
FIN_WAIT2--ローカルホストは TCP 接続を閉じ、送信した FIN セグメントの ACK を受信しましたが、オフロードされた接続は引き続きリモートホストからデータを受信している可能性があります。
CLOSE_WAIT--ローカルホストは引き続きデータを送信している可能性があります。

オフロードターゲットは、オフロードされたすべての TCP 接続の終了を要求できます。詳細については、「 NdisMOffloadEventIndicate」を参照してください。

Send Backlog サイズの変更を示す

送信バックログサイズは、接続、インターフェイス帯域幅、およびその他のパラメーターのラウンドトリップ時間 (RTT) の関数です。オフロードターゲットが送信バックログサイズの計算に使用する特定の変数とアルゴリズムは、実装固有です。たとえば、オフロードターゲットでは、帯域幅遅延製品とアドバタイズされた受信ウィンドウの最小値をアルゴリズムとして使用できます。ただし、送信バックログのサイズは、接続での送信のために現在投稿されているデータバイト数によって異ならない点に注意してください。

オフロードターゲットでは、 SendBacklogSize の値が頻繁に変更される場合や量が少なすぎる場合に、オフロードターゲットが SendBacklogSize イベントを示さないことを確認するために、調整メカニズムを実装する必要があります。これにより、イベントの兆候の嵐が発生するのを防ぐことができます。