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 | 任意のレベル |