TCP_OFFLOAD_EVENT_HANDLER コールバック関数 (ndischimney.h)
[TCP のチムニー オフロード機能は非推奨であり、使用しないでください。]
NDIS は、プロトコル ドライバーまたは中間ドライバーの ProtocolIndicateOffloadEvent 関数を呼び出して、基になるドライバーまたはオフロード ターゲットの 呼び出しによって開始されたインジケーターを に投稿します。 NdisTcpOffloadEventHandler 関数。
構文
TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;
void TcpOffloadEventHandler(
[in] IN PVOID OffloadContext,
[in] IN ULONG EventType,
[in] IN ULONG EventSpecificInformation
)
{...}
パラメーター
[in] OffloadContext
示す TCP 接続のプロトコルまたは中間ドライバーの NDIS_OFFLOAD_HANDLE 構造体へのポインター。 プロトコルまたは中間ドライバーは、接続のオフロード時に NdisInitiateOffload 関数に入力パラメーターとしてこのポインターを指定しました。
[in] EventType
次のTCP_OFFLOAD_EVENT_TYPE値のいずれかとして示されているイベント。
TcpIndicateDisconnect
リモート ホストが接続で FIN セグメントを送信することによって正常な切断を開始したことを示します。
TcpIndicateRetrieve
オフロード ターゲットが、TCP 接続のオフロードを終了するようにホスト スタックに要求していることを示します。
TcpIndicateAbort
リモート ホストが接続で許容可能な RST セグメントを送信することによって中止切断を開始したことを示します。
TcpIndicateSendBacklogChange
優先する送信バックログ サイズの変更を示します。
[in] EventSpecificInformation
次のように示されるイベントに関する追加情報を指定します。
TcpIndicateDisconnect
意味がありません。
TcpIndicateRetrieve
アップロード要求の理由をTCP_UPLOAD_REASON値として示します。 詳細については、「 NdisTcpOffloadEventHandler。
TcpIndicateAbort
意味がありません。
TcpIndicateSendBacklogChange
最適なデータ スループットを実現するために、オフロード ターゲットでホスト スタックが未処理にする必要がある送信データ バイトの最適な数を指定します。
戻り値
なし
解説
上にあるドライバーまたはホスト スタックにインジケーターを伝達するために、中間ドライバーは NdisTcpOffloadEventHandler 関数を呼び出します。 中間ドライバーは、次のパラメーターを に渡します。
NdisTcpOffloadEventHandler 関数:
- オフロードされた TCP 接続のコンテキストにオフロード ターゲットが格納されている NdisOffloadHandle 。 詳細については、「 中間ドライバーを介したオフロード状態の参照。
- NDIS が中間ドライバーの ProtocolTcpOffloadEvent 関数に渡した EventType。
- NDIS が中間ドライバーの ProtocolTcpOffloadEvent 関数に渡した EventSpecificInformation。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | ndischimney.h (Ndischimney.h を含む) |