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

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

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

MiniportUpdateOffload 関数は、以前にオフロードされた TCP チムニー状態オブジェクトを更新します。

構文

W_UPDATE_OFFLOAD_HANDLER WUpdateOffloadHandler;

void WUpdateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

パラメーター

[in] MiniportAdapterContext

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

[in] OffloadBlockList

へのポインター NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 構造体。このような構造体のリンクされたリストのルートにすることができます。これらの構造体は、更新されるオフロード状態オブジェクトを識別します。キャッシュされた変数のみが更新されます。

戻り値

なし

解説

キャッシュされた変数のみが更新されます。

MiniportUpdateOffload 関数は、MiniportAdapterContext ハンドルと OffloadBlockList ポインターを格納し、を返します。オフロードターゲットは常に、を呼び出して更新操作を非同期的に完了します。 NdisMUpdateOffloadComplete 関数。 OffloadBlockList ポインターは、スタンドアロン構造または複数のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造を含むオフロード状態ツリー内のルートブロックリストのいずれかにすることができるNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体を指します。このようなブロックリスト、およびそれらに関連付けられているオフロード状態構造は、ミニポートドライバーがを呼び出すまで有効です。 NdisMUpdateOffloadComplete 関数。

MiniportUpdateOffload 関数が戻る前に、オフロードターゲットは、MiniportUpdateOffload 関数に渡されたオフロード状態ツリーを使用してオフロード状態を更新します。

オフロードターゲットは、ツリー内の任意の状態構造体から対応するオフロード状態オブジェクトに変数値をコピーします。 CACHED 変数のみが更新されます。
ツリーは、近隣へのパスリンクを更新する必要があることを示している可能性があります。詳細については、「パス状態オブジェクトを新しい近隣状態オブジェクトにリンクする」を参照してください。この場合、オフロードターゲットは、更新されたリンクを反映するようにオフロード状態の内部表現を更新する必要があります。