NdisOffloadTcpForward 関数 (ndischimney.h)

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

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

プロトコルドライバーまたは中間ドライバーは 、NdisOffloadTcpForward 関数を呼び出して、未確認の受信 TCP セグメントを基になるドライバーまたはオフロードターゲットに転送します。

構文

NDIS_STATUS NdisOffloadTcpForward(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList
);

パラメーター

[in] NdisOffloadHandle

オフロードされた TCP 接続の呼び出し元のコンテキストで NDIS_OFFLOAD_HANDLE 構造体へのハンドル。詳細については、「中間ドライバーを介したオフロード状態の参照。

[in] NetBufferList

NET_BUFFER_LIST構造体へのポインター。この構造体には、スタンドアロン構造、またはNET_BUFFER_LIST構造体のリンクされたリスト内の最初の構造体を指定できます。リスト内の各NET_BUFFER_LIST構造体には、1 つの NET_BUFFER 構造体が記述されています。各NET_BUFFER構造体は、メモリ記述子リスト (MCL) のチェーンを指します。 NET_BUFFER構造体に関連付けられている MPL には、オフロードターゲットに転送される TCP セグメントが 1 つだけ含まれています。最初の MDL の最初のバイトは、TCP ヘッダーの最初のバイトです。 NET_BUFFER_LISTおよび関連する構造体は、物理メモリに常駐し続けることができるようにロックされます。ただし、システムメモリにはマップされません。

戻り値

NdisOffloadTcpForward 関数は常にNDIS_STATUS_PENDINGを返します。転送操作は常に非同期的に完了します。

注釈

MiniportTcpOffloadForward 関数の呼び出しに応答して、中間ドライバーは NdisOffloadTcpForward 関数を呼び出して、転送操作を基になるドライバーまたはオフロードターゲットに伝達します。詳細については、「 I/O 操作の伝達」を参照してください。

NdisOffloadTcpForward 関数に中間ドライバーは、次を渡します。

オフロードされた TCP 接続の中間ドライバーのコンテキストに格納されているNDIS_OFFLOAD_HANDLE構造体を参照する NdisOffloadHandle 関数。詳細については、「中間ドライバーを介したオフロード状態の参照。
NDIS が中間ドライバーに渡したのと同じPNET_BUFFER_LIST ポインター MiniportTcpOffloadForward 関数。

基になるドライバーまたはオフロードターゲットが後で NdisTcpOffloadForwardComplete 関数を呼び出して前方操作を完了すると、NDIS は中間ドライバーの ProtocolOffloadForwardComplete 関数を呼び出します。その後、中間ドライバーは NdisTcpOffloadForwardComplete 関数を呼び出して、前方操作の完了を伝達します。