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

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

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

NDIS は、プロトコルドライバーまたは中間ドライバーの ProtocolTcpOffloadDisconnectComplete 関数を呼び出して、ドライバーが以前に開始した切断操作を完了します。 NdisOffloadTcpDisconnect 関数。

構文

TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;

void TcpOffloadDisconnectCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

パラメーター

[in] ProtocolBindingContext

プロトコルドライバーによって割り当てられたコンテキスト領域へのハンドル。ドライバーは、このコンテキスト領域でバインドごとのコンテキスト情報を保持します。ドライバーは、ドライバーが NdisOpenAdapterEx 関数を呼び出したときに、NDIS にこのハンドルを提供しました。

[in] NetBufferList

NULL 以外の場合は、単一の NET_BUFFER_LIST 構造体へのポインター。ドライバーは、への以前の呼び出しでこのポインターを入力パラメーターとして指定しました。 NdisOffloadTcpDisconnect 関数。

戻り値

なし

解説

基になるドライバーまたはオフロードターゲットのへの呼び出しに応答して、 NdisTcpOffloadDisconnectComplete 関数では、NDIS は、上にあるプロトコルドライバーまたは中間ドライバーの ProtocolTcpOffloadDisconnectComplete 関数を呼び出します。

切断操作の完了を上にあるドライバーに伝達するために、中間ドライバーは NdisOffloadTcpDisconnectComplete 関数を呼び出し、次を渡します。

ProtocolBindingContext。中間ドライバーを一意に識別するハンドルです。
NDIS が中間ドライバーの ProtocolTcpOffloadDisconnectComplete 関数に渡したのと同じPNET_BUFFER_LISTポインター。

応答として、NDIS は、上にあるドライバーの ProtocolTcpOffloadDisconnectComplete 関数を呼び出し、 ProtocolBindingContext ハンドルと、中間ドライバーによって渡されたPNET_BUFFER_LIST ポインターを NdisOffloadTcpDisconnectComplete 関数に渡します。

戻る前に、 ProtocolTcpOffloadDisconnectComplete 関数は、関数に渡されたNET_BUFFER_LIST構造体に対して作成したコンテキストのメモリの割り当てを解除する必要があります。

中間ドライバーが複数のインターフェイスを上にあるプロトコルにエクスポートする場合、切断の完了を受け取るプロトコルを決定する必要があることに注意してください。この決定を行うために、中間ドライバーは、に格納されている情報を使用します。 NET_BUFFER_LIST_CONTEXT 構造体。これは、NET_BUFFER_LIST構造体に関連付けられています。