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

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

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

オフロードターゲットは NdisTcpOffloadReceiveComplete 関数を呼び出して、ポストされた受信要求 (受信バッファー) をホストスタックに返します。オフロードターゲットは、への 1 つ以上の呼び出しで以前に受信要求を受信しました MiniportTcpOffloadReceive 関数。

構文

NDIS_TCP_OFFLOAD_RECEIVE_COMPLETE NdisTcpOffloadReceiveComplete;

void NdisTcpOffloadReceiveComplete(
  [in] IN NDIS_HANDLE NdisMiniportHandle,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

パラメーター

[in] NdisMiniportHandle

の前の呼び出しでオフロードターゲットが取得したハンドル。 NdisMRegisterMiniportDriver 関数。

[in] NetBufferList

NET_BUFFER_LIST構造体へのポインター。この構造体は、スタンドアロンまたはNET_BUFFER_LIST構造体のリンクされたリスト内の最初の構造体にすることができます。オフロードターゲットは、への 1 つ以上の呼び出しでこれらの構造体を取得しました MiniportTcpOffloadReceive 関数。

戻り値

なし

解説

オフロードターゲットは、を使用し、要求がに投稿された順序で事前にポストされた受信要求を返す必要がありますオフロードターゲットの MiniportTcpOffloadReceive 関数。つまり、オフロードターゲットはを使用し、先入れ先出し (FIFO) 順に事前にポストされた受信要求を返す必要があります。

オフロードターゲットは、 NdisTcpOffloadReceiveComplete 関数とへの呼び出しをシリアル化する必要があります。接続ごとに NdisTcpOffloadReceiveHandler 関数。

オフロードターゲットの MiniportTcpOffloadReceive 関数は、 NdisTcpOffloadReceiveComplete 関数へのオフロードターゲットの呼び出しのコンテキストで呼び出すことができます。この場合、 NdisTcpOffloadReceiveComplete への前回の呼び出しが返されるまで、オフロードターゲットは NdisTcpOffloadReceiveComplete 関数を再度呼び出す必要があります。

システムパフォーマンスを向上させるために、オフロードターゲットは、複数の呼び出しからへの NET_BUFFER_LIST 構造を含むリンクリストを作成できます。 MiniportTcpOffloadReceive 関数。オフロードターゲットは、 NdisTcpOffloadReceiveComplete 関数への 1 回の呼び出しで、このようなリンクされたリストを渡すことができます。オフロードターゲットは、への 1 回の呼び出しで投稿された受信要求を分散できることに注意してください。オフロードターゲットが、MiniportTcpOffloadReceive 関数にポストされたのと同じ順序で受信要求を完了する限り、複数の完了呼び出しにわたって MiniportTcpOffloadReceive 関数。

NdisTcpOffloadReceiveComplete 関数を呼び出す前に、オフロードターゲットは、関数に渡す各NET_BUFFER_LIST構造体に対して次の処理を行います。

Status メンバーに次のいずれかの状態値を書き込みます。

NDIS_STATUS_SUCCESS

オフロードターゲットは、 NetBufferList パラメーターによって参照されるNET_BUFFER_LIST構造体に関連付けられているすべてのデータを受信しました。また、オフロードターゲットは、TCP 接続の TCP 委任状態で RcvNxt 変数と RcvWnd 変数を拡張しました。オフロードターゲットが遅延受信確認の送信を待機しているかどうかに応じて、オフロードターゲットが受信データの受信確認を生成した場合と生成されていない場合があります。

NDIS_STATUS_REQUEST_ABORTED

オフロードターゲットが受信データの処理中にエラーが発生しました。オフロードターゲットが 、NetBufferList パラメーターによって指されるNET_BUFFER_LIST構造体を持つ有効なデータを提供している場合、オフロードターゲットは、NET_BUFFER_LIST_INFO マクロを呼び出すことによって有効なデータバイト数を指定します。オフロードターゲットは、受信したデータの一部を確認した場合と受信していない可能性があります。

NDIS_STATUS_UPLOAD_IN_PROGRESS

バッファーが投稿された接続がアップロードされています。

NDIS_STATUS_INVALID_STATE

オフロードターゲットがを呼び出して切断を示した後、受信要求がポストされました NdisTcpOffloadEventHandler。

id が TcpOffloadBytesTransferred のNET_BUFFER_LIST_INFO マクロを呼び出して返されるデータバイト数を指定します。
を呼び出します。 NdisAdvanceNetBufferDataStart 関数。 NetBufferList パラメーターは、NET_BUFFER_LIST構造体に関連付けられているNET_BUFFER構造体を指す必要があります。 DataOffsetDelta パラメーターは、NET_BUFFER構造体に関連付けられているメモリ記述子リスト (MDL) にオフロードターゲットが配置したデータバイト数を指定する必要があります。 FreeMdl パラメーターは NULL にする必要があります。