NdisOffloadTcpReceive 関数 (ndischimney.h)

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

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

プロトコルドライバーまたは中間ドライバーは、 NdisOffloadTcpReceive 関数を呼び出して、オフロードされた TCP 接続で受信要求 (受信バッファー) を投稿します。

構文

NDIS_STATUS NdisOffloadTcpReceive(
  [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構造体は、メモリ記述子リスト (MDL) のチェーンを指します。 NET_BUFFER_LISTおよび関連する構造体は、物理メモリに常駐し続けることができるようにロックされます。ただし、システムメモリにはマップされません。

戻り値

NdisOffloadTcpReceive 関数は常にNDIS_STATUS_PENDINGを返します。受信操作は常に非同期的に完了します。

注釈

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

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

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

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