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

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

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

MiniportQueryOffload 関数は、以前にオフロードされた TCP チムニー状態オブジェクトに対してクエリを実行します。

構文

W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;

void WQueryOffloadHandler(
  [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 構造体。このような構造体のリンクされたリストのルートにすることができます。これらの構造体は、クエリ対象のオフロード状態を識別します。

戻り値

なし

解説

MiniportQueryOffload 関数は、オフロードターゲットにオフロードされた TCP チムニー状態を照会できます。

MiniportQueryOffload 関数は、OffloadBlockList ポインターを格納し、を返します。オフロードターゲットは常に、を呼び出してクエリ操作を非同期的に完了します。 NdisMQueryOffloadStateComplete 関数。 OffloadBlockList ポインターは、 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST スタンドアロン構造またはオフロード状態ツリー内のルートノードのいずれかにすることができる構造体です。状態ツリーは、オフロードターゲットが NdisMQueryOffloadStateComplete 関数を呼び出すまで有効です。

MiniportQueryOffload 関数から戻った後、ミニポートドライバーは、OffloadBlockList ポインターによって指される状態ツリー内の各NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられているオフロード状態構造体を入力します。これらのオフロード状態構造体のそれぞれに、ミニポートドライバーは構造体内の各変数の現在の値を書き込みます。

NdisMQueryOffloadStateComplete 関数を呼び出す前に、オフロードターゲットは、状態ツリー内の各NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体の Status メンバーに次のNDIS_STATUS値のいずれかを書き込む必要があります。