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

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

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

MiniportTerminateOffload 関数は、1 つ以上の状態オブジェクトのオフロードを終了します。

構文

W_TERMINATE_OFFLOAD_HANDLER WTerminateOffloadHandler;

void WTerminateOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

パラメーター

[in] MiniportAdapterContext

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

[in, out] OffloadBlockList

へのポインター NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 構造体。このような構造体のリンクされたリストのルートにすることができます。これらの構造体は、終了しているオフロード状態オブジェクトを識別します。

戻り値

なし

解説

MiniportTerminateOffload 関数は、OffloadBlockList ポインターを格納し、を返します。オフロードターゲットは、常にを呼び出すことによって非同期的に終了操作を完了します。 NdisMTerminateOffloadComplete 関数。

OffloadBlockList ポインターは、複数のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体を含むオフロード状態ツリー内のスタンドアロン構造体またはルートブロックリストのいずれかにできるNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体を指します。このようなブロックリストと、それらに関連付けられているオフロード状態構造は、ミニポートドライバーが NdisMTerminateOffloadComplete 関数を呼び出すまで有効です。

各NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体は、委任された状態構造体 (XXX_OFFLOAD_STATE_DELEGATED) によってメモリ内ですぐに実行できます。オフロードターゲットは、委任された変数値を、ホストスタックによって提供される委任された状態構造体にコピーします。

次の両方の条件が満たされるまで、ホストスタックは TCP 接続のオフロードの終了を要求しません。