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

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

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

構文

W_INVALIDATE_OFFLOAD_HANDLER WInvalidateOffloadHandler;

void WInvalidateOffloadHandler(
  [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 構造体。このような構造体のリンクされたリストのルートにすることができます。 これらの構造体は、無効化されているオフロード状態オブジェクトを識別します。

戻り値

なし

解説

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

MiniportInvalidateOffload 関数に渡されるツリーには、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体のみが含まれます。 ツリーには オフロード状態構造体が含まれていません。 つまり、メモリ内の NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 構造体に続くこのような構造体はありません。

ツリー内のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体は、無効にする状態オブジェクトを示します。 NULL 以外の *MiniportOffloadContext メンバーは、状態オブジェクトがオフロードされたときにオフロード ターゲットによって提供された PVOID 値を含むメモリの場所を指します。 詳細については、「 オフロード状態の格納と参照」を参照してください。 この PVOID 値は、オフロード ターゲットが無効にする状態オブジェクトを格納するミニポート オフロード コンテキストを参照します。

オフロード ターゲットによる無効化された状態オブジェクトの処理については、「無効化 された状態オブジェクトの処理」を参照してください。

最終的に、ホスト スタックは 無効化された状態オブジェクトのオフロードを終了します。 ただし、その時点まで、オフロード ターゲットは無効化された状態オブジェクトを所有します。 オフロード ターゲットは、ホスト スタックがその状態オブジェクトのオフロードを終了するまで、無効化された状態オブジェクトのリソースを解放することはできません。 オフロード ターゲットでは、無効化された状態オブジェクト、またはその状態オブジェクトに依存する TCP 接続を使用してデータを送信することはできません。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	ndischimney.h (Ndischimney.h を含む)
IRQL	任意のレベル

こちらもご覧ください

MiniportInitializeEx

NdisMInvalidateOffloadComplete のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST

NdisMSetMiniportAttributes