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

[アーティクル]
03/05/2024

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

NDIS は 、ミニポートTcpOffloadSend 関数を呼び出して、オフロードされた TCP 接続でデータを送信します。

構文

W_TCP_OFFLOAD_SEND_HANDLER WTcpOffloadSendHandler;

NDIS_STATUS WTcpOffloadSendHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PVOID MiniportOffloadContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

パラメーター

[in] MiniportAdapterContext

オフロードターゲットがアダプターのこのインスタンスに関する状態情報を保持するオフロードターゲット割り当てコンテキスト領域へのハンドル。オフロードターゲットは、呼び出されたときに NDIS にこのハンドルを提供しました NdisMSetMiniportAttributes MiniportInitializeEx 関数。

[in] MiniportOffloadContext

PVOID 値を含むメモリの場所へのポインター。この PVOID 値は、データを送信する TCP 接続の状態オブジェクトを含むミニポートオフロードコンテキストを参照します。オフロードターゲットは、TCP 接続状態オブジェクトをオフロードしたときに、この PVOID 値を指定しました。

[in] NetBufferList

NET_BUFFER_LIST構造体へのポインター。この構造体には、スタンドアロン構造、またはNET_BUFFER_LIST構造のリンクされたリスト内の最初の構造体を指定できます。リスト内の各NET_BUFFER_LIST構造体は、 NET_BUFFER 構造体の一覧を記述します。リスト内の各NET_BUFFER構造は、メモリ記述子リスト (MDL) のチェーンにマップされます。 MDP には、送信するデータが含まれます。 NET_BUFFER_LISTおよび関連する構造体は、物理メモリに常駐するようにロックされます。ただし、システムメモリにはマップされません。

戻り値

NDIS_STATUS_PENDINGは、許可される唯一の戻り値です。オフロードターゲットは、常にを呼び出して非同期的に送信要求を完了します NdisTcpOffloadSendComplete。

注釈

オフロードターゲットは、先入れ先出し (FIFO) 順にデータを送信する必要があります。 NDIS が NetBufferList で渡すNET_BUFFER_LIST構造体のリンクリストの順序は、オフロードターゲットがネットワークデータを送信する必要がある順序を表します。さらに、オフロードターゲットは、複数の呼び出しから受信したデータを、データが投稿された順序で MiniportTcpOffloadSend に送信する必要があります。

オフロードターゲットは、 その MiniportTcpOffloadSend 関数に対して行われたすべての送信要求を受け入れる必要があります。オフロードターゲットが送信要求をすぐに完了できない場合、オフロードターゲットは要求を完了するまでキューに入れる必要があります。オフロードターゲットでは、送信要求をキューに格納するために、NET_BUFFER_LIST構造体の ミニポート予約 メンバーを使用する必要があります。送信要求が保留中の間、オフロードターゲットは、NET_BUFFER_LIST構造体と、NET_BUFFER_LIST構造体に関連付けられているすべてのリソースの所有権を保持します。

ホストスタックは、接続ごとに送信要求をシリアル化します。スタックは、接続に対する別の送信要求が進行中の間、接続に対して送信要求を発行しません。これにより、オフロードターゲットは常に正しい順序で送信要求を受け取ります。

ただし、オフロードターゲットが同じ接続で MiniportTcpOffloadSend 関数の以前の呼び出しを 1 つ以上完了する前に、ホストスタックが接続で MiniportTcpOffloadSend 関数を呼び出すことができることに注意してください。また、ホストスタックは、1 つの接続でオフロードターゲットの MiniportTcpOffloadSend 関数を呼び出すことができますが、1 つ以上の MiniportTcpOffloadSend 関数の呼び出しは別の接続で進行中です。

MiniportTcpOffloadSend 関数は、ネットワークデータの内部キューへのアクセスを、同じキューにアクセスするオフロードターゲットの他の MiniportXxx 関数と同期する必要があります。オフロードターゲットでは、スピンロックを使用してキューへのアクセスを同期できます。

オフロードターゲットは、各NET_BUFFER_LIST境界に PSH ビットを設定する必要があります (ただし、必須ではありません)。これを行うための推奨される方法は、各NET_BUFFER_LIST構造体に関連付けられたデータ (つまり、NET_BUFFER_LIST構造体に関連付けられたNET_BUFFER構造体によって記述されるデータ) から作成された最後のセグメントに PSH ビットを設定することです。または、オフロードターゲットは、送信キューが空になる前に、送信キューの最後の残りのセグメントに PSH ビットを設定できます。

ホストスタックは、緊急データの送信をオフロードターゲットに要求しません。