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

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

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

NDIS は 、ミニポートTcpOffloadReceiveReturn 関数を呼び出して、オフロードターゲットにNET_BUFFER_LISTおよび関連する構造体の所有権を返します。

構文

W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER WTcpOffloadReceiveReturnHandler;

NDIS_STATUS WTcpOffloadReceiveReturnHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

パラメーター

[in] MiniportAdapterContext

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

[in] NetBufferList

NET_BUFFER_LIST構造体へのポインター。この構造体には、スタンドアロン構造、またはNET_BUFFER_LIST構造体のリンクされたリスト内の最初の構造体を指定できます。リンクリストには、への 1 つ以上の呼び出しからNET_BUFFER_LIST構造体を含めることができます。 NdisTcpOffloadReceiveHandler 関数。

戻り値

MiniportTcpOffloadReceiveReturn 関数は常に成功するはずです。したがって、 MiniportTcpOffloadReceiveReturn 関数は常にNDIS_STATUS_SUCCESSを返す必要があります。

注釈

NDIS は 、ミニポートTcpOffloadReceiveReturn 関数を呼び出して、オフロードターゲットが 1 つ以上の以前の呼び出しで渡したNET_BUFFER_LIST構造体と関連する構造体の所有権を返します。 NdisTcpOffloadReceiveHandler 関数。

MiniportTcpOffloadReceiveReturn 関数は、後続の受信指示で使用するために、返されたNET_BUFFER_LIST構造体を準備できます。 MiniportTcpOffloadReceiveReturn 関数はNET_BUFFER_LIST構造体をプールに返すことができます (たとえば、NdisFreeNetBufferList 関数を呼び出すことができます)、プールに構造体を返さずに再利用する方が効率的です。

オフロードターゲットドライバーはアンロードせず、指定されたすべての受信バッファーが返されるまでオフロードターゲットアダプターを閉じてはならないことに注意してください。