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

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

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

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

構文

INITIATE_OFFLOAD_COMPLETE_HANDLER InitiateOffloadCompleteHandler;

void InitiateOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

パラメーター

[in] ProtocolBindingContext

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

[in] OffloadBlockList

スタンドアロン構造、またはそのような構造体のリンクされたリストのルートを指定できる、 NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST 構造体へのポインター。これらの構造体は、オフロードされた状態、またはオフロードしようとした状態を識別します。

戻り値

なし

解説

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

中間ドライバーは、 NdisMInitiateOffloadComplete を呼び出すことによって、オフロード開始操作の完了をその上のドライバーに伝達する必要があります。詳細については、「 State-Manipulation 操作の完了の伝達」を参照してください。

ProtocolInitiateOffloadComplete 関数に渡されたNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体から、中間ドライバーはNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体を構築します。

詳細については、「 NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体の再利用」を参照してください。 NdisMInitiateOffloadComplete 関数を呼び出すと、中間ドライバーは、この新しく構築されたNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体へのポインター (OffloadBlockList パラメーター) を渡します。