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

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

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

MiniportInitiateOffload は、ホストスタックから TCP チムニーの状態をオフロードします。

構文

W_INITIATE_OFFLOAD_HANDLER WInitiateOffloadHandler;

void WInitiateOffloadHandler(
  [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 スタンドアロン構造、またはそのような構造体のリンクされたリストのルートにすることができます。

戻り値

なし

解説

MiniportInitiateOffload 関数は、OffloadBlockList ポインターを格納し、を返します。オフロードターゲットは、常にを呼び出すことによって、オフロード操作を非同期的に完了します NdisMInitiateOffloadComplete。 OffloadBlockList ポインターが指す状態ツリーは、ミニポートドライバーが NdisMInitiateOffloadComplete を呼び出すまで有効です。

MiniportInitiateOffload 関数から戻った後、オフロードターゲットは状態ツリーから状態をオフロードします。 MiniportOffloadContext メンバーが NULL 値を含むメモリの場所を指すNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体の後に、オフロードする状態が続きます。詳細については、「オフロード状態の格納と参照」を参照してください。 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体の Header メンバーには、オフロード状態の種類を指定する Type メンバーと、メモリ内のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体の直後にあるオフロード状態の構造体が含まれます。

オフロードターゲットは、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられているオフロード状態をオフロードコンテキスト領域にオフロードします。詳細については、「オフロード状態の格納と参照」を参照してください。

状態をオフロードする場合、オフロードターゲットは、深さ優先または幅の次の方法で状態ツリーを走査する必要があります。オフロードターゲットは、この方法で状態をオフロードすることが重要です。

MiniportInitiateOffload 関数に渡される状態ツリー内のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造の一部は、オフロードする付随する状態を持たないプレースホルダーまたはリンクノードにすることができます。詳細については、「プレースホルダー、リンカー、および新しいオフロード」を参照してください。

オフロードターゲットは、オフロードされている接続のバッファーされたデータをホストスタックから受信できます。オフロードターゲットは、オフロード操作を完了する前に、このデータを独自のバッファーにコピーする必要があります。バッファー処理された受信データの処理の詳細については、次を参照してください。オフロード操作中およびオフロード操作後にバッファー処理された受信データを処理する。

オフロード対象の状態オブジェクトごとに、オフロードターゲットが状態オブジェクトを格納するオフロードコンテキスト領域を参照する PVOID 値も指定する必要があります。オフロードターゲットは、この PVOID 値を、状態に関連付けられているNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体の *MiniportOffloadContext メンバーが指すメモリの場所に書き込みます。オフロードターゲットが、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態を正常にオフロードしなかった場合は、 *MiniportOffloadContext メンバーが指すメモリの場所に値を書き込まないようにする必要があります。詳細については、「オフロード状態の格納と参照」を参照してください。