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

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

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

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

構文

UPDATE_OFFLOAD_COMPLETE_HANDLER UpdateOffloadCompleteHandler;

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

パラメーター

[in] ProtocolBindingContext

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

[in] OffloadBlockList

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

戻り値

なし

解説

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

中間ドライバーは、 NdisMUpdateOffloadComplete を呼び出すことによって、その上のドライバーに更新オフロード操作の完了を伝達する必要があります。詳細については、「 State-Manipulation 操作の完了の伝達。

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