NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体 (ndischimney.h)
[TCP のチムニー オフロード機能は非推奨であり、使用しないでください。]
NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体。
構文
typedef struct _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST {
IN NDIS_OBJECT_HEADER Header;
IN _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST *NextBlock;
#if ...
struct _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST;
IN _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST *DependentBlockList;
#else
struct _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST;
#endif
OUT NDIS_STATUS Status;
IN PVOID NdisReserved[3];
IN OUT PNDIS_OFFLOAD_HANDLE OffloadHandle;
IN PVOID ProtocolReserved[2];
IN PVOID MiniportReserved[2];
IN PVOID ImReserved[2];
IN PVOID Scratch[2];
IN PVOID SourceHandle;
IN NDIS_PORT_NUMBER PortNumber;
IN OUT PNET_BUFFER_LIST NetBufferListChain;
} NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST, *PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST;
メンバー
Header
NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体のヘッダー。 ヘッダーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。 NDIS_OBJECT_HEADER構造体には、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体のリビジョン番号、メモリ内のNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体の直後にあるオフロード状態の種類、およびヘッダーを含むNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体のサイズ (バイト単位) が含まれます。
NDIS_OBJECT_HEADER構造体の Type メンバーは、オフロード状態の種類を示し、メモリ内のNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に直ちに続く特定のオフロード状態構造 (または構造体) を意味します。
次のOFFLOAD_STATE_TYPE値がサポートされています。
NeighborOffloadConstState
定数近隣状態を指定します。 この状態は、 NEIGHBOR_OFFLOAD_STATE_CONST 構造体。
NeighborOffloadCachedState
キャッシュされた近隣状態を指定します。 この状態は、 NEIGHBOR_OFFLOAD_STATE_CACHED 構造体。
NeighborOffloadDelegatedState
委任された近隣状態を指定します。 この状態は、 NEIGHBOR_OFFLOAD_STATE_DELEGATED 構造体。
NeighborOffloadState
定数、キャッシュ済み、委任された近隣状態など、すべての近隣状態を指定します。 この状態は、NEIGHBOR_OFFLOAD_STATE_CONST構造体として書式設定され、その後にNEIGHBOR_OFFLOAD_STATE_CACHED構造体が続き、その後に NEIGHBOR_OFFLOAD_STATE_DELEGATED 構造体が続きます。
Ip4OffloadConstState
定数パスの状態 (IPv4) を指定します。 この状態は、 PATH_OFFLOAD_STATE_CONST 構造体。
Ip4OffloadCachedState
キャッシュされたパスの状態 (IPv4) を指定します。 この状態は、 PATH_OFFLOAD_STATE_CACHED 構造体。
Ip4OffloadDelegatedState
委任されたパスの状態 (IPv4) を指定します。 この状態は、 PATH_OFFLOAD_STATE_DELEGATED 構造体。 現在、委任されたパスの状態はありません。 PATH_OFFLOAD_STATE_DELEGATED構造体には変数が含まれていません。
Ip4OffloadState
定数、キャッシュ、委任されたパスの状態を含むすべてのパス状態 (IPv4) を指定します。 この状態は、PATH_OFFLOAD_STATE_CONST構造体として書式設定され、その後にPATH_OFFLOAD_STATE_CACHED構造体が続き、その後に PATH_OFFLOAD_STATE_DELEGATED 構造体が続きます。
Ip6OffloadConstState
定数パスの状態 (IPv6) を指定します。 この状態は、PATH_OFFLOAD_STATE_CONST構造体として書式設定されます。
Ip6OffloadCachedState
キャッシュされたパスの状態 (IPv6) を指定します。 この状態は、PATH_OFFLOAD_STATE_CACHED構造体として書式設定されます。
Ip6OffloadDelegatedState
委任されたパスの状態 (IPv6) を指定します。 この状態は、PATH_OFFLOAD_STATE_DELEGATED構造体として書式設定されます。 現在、委任されたパスの状態はありません。 PATH_OFFLOAD_STATE_DELEGATED構造体には変数が含まれていません。
Ip6OffloadState
定数、キャッシュ、委任されたパスの状態を含むすべてのパス状態 (IPv6) を指定します。 この状態は、PATH_OFFLOAD_STATE_CONST構造体として書式設定され、その後にPATH_OFFLOAD_STATE_CACHED構造体が続き、その後に PATH_OFFLOAD_STATE_DELEGATED 構造体が続きます。
TcpOffloadConstState
定数 TCP 状態を指定します。 この状態は、 TCP_OFFLOAD_STATE_CONST 構造体。
TcpOffloadCachedState
キャッシュされた TCP 状態を指定します。 この状態は、 TCP_OFFLOAD_STATE_CACHED 構造体。
TcpOffloadDelegatedState
委任された TCP 状態を指定します。 この状態は、 TCP_OFFLOAD_STATE_DELEGATED 構造体。
TcpOffloadResourceState
予約済み。 このOFFLOAD_STATE_TYPE値とTCP_OFFLOAD_RESOURCE_STATE構造体は現在使用されていません。
TcpOffloadState
定数、キャッシュ、委任された TCP 状態を含むすべての TCP 状態を指定します。 この状態は、TCP_OFFLOAD_STATE_CONST構造体として書式設定され、その後にTCP_OFFLOAD_STATE_CACHED構造体が続き、その後に TCP_OFFLOAD_STATE_DELEGATED 構造体が続きます。
FilterReservedOffloadState
フィルター ドライバー用に予約されています。
NextBlock
ヘッダー メンバーの Type メンバーによって示されるオフロード状態レイヤー (近隣、パス、または TCP) にある次のNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体へのポインター。 NextBlock ポインターを介してリンクされているNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体は、常にオフロード状態の同じレイヤーにあります。 NextBlock の値が NULL の場合、このレベルに次のNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体が追加されていないことを示します。
_NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST
DependentBlockList
オフロード状態の依存レイヤー (オフロード状態ツリーの上位レイヤー) にあるNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体へのポインター。
TCP チムニー オフロードの場合:
近隣レイヤーのNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体の DependentBlockList メンバーは、パス レイヤーのNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体のみを指すことができます。 パス レイヤーのNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体の DependentBlockList メンバーは、TCP レイヤーのNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体のみを指すことができます。 TCP レイヤーのNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体の DependentBlockList メンバーは常に NULL です。
DependentBlockList の値が NULL の場合、依存NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体がないことを示します。
Status
オフロードの開始、クエリ オフロード、更新オフロード、オフロードの無効化、オフロードの終了操作の完了状態。オフロード ターゲットは、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST 構造体に関連付けられている状態で実行されるか、またはによって参照されます。 操作に応じて、NDIS は Status メンバーに次のいずれかのNDIS_STATUS値を書き込みます。
NDIS_STATUS_SUCCESS
オフロードの開始: 基になるオフロード ターゲットは、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態と、直ちに依存するすべてのPROTOCOL_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態を正常にオフロードしました。
クエリ、更新、無効化、または終了オフロード: オフロード ターゲットは、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態または参照先の状態に対して操作を正常に実行しました。
NDIS_STATUS_OFFLOAD_PARTIAL_SUCCESS
オフロードの開始: 基になるオフロード ターゲットは、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態を正常にオフロードしましたが、直ちに依存する 1 つ以上のNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。
クエリ、更新、無効化、または終了オフロード: 許可された状態値ではありません。
NDIS_STATUS_FAILURE
オフロードの開始: 基になるオフロード ターゲットが、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。 エラーの原因を分類することはできません。
クエリ、更新、無効化、または終了オフロード: オフロード ターゲットは、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている、または参照されている状態に対して操作を実行できませんでした。
NDIS_STATUS_RESOURCES
オフロードの開始: オフロード ターゲットは、十分なホスト メモリを割り当てることができなかったため、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_TCP_ENTRIES
オフロードの開始: オフロード ターゲットは TCP 接続状態オブジェクトを割り当てられなかったため、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_PATH_ENTRIES
オフロードの開始: オフロード ターゲットはパス状態オブジェクトを割り当てられなかったため、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_NEIGHBOR_ENTRIES
オフロードの開始: オフロード ターゲットは近隣状態オブジェクトを割り当てられなかったため、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_HW_ADDRESS_ENTRIES
オフロードの開始: オフロード ターゲットは、ホスト スタックで NULL 以外の DlSourceAddress メンバーを指定したため、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした NEIGHBOR_OFFLOAD_STATE_CONST 構造とオフロード ターゲットは、構成可能なソース MAC アドレスをサポートしていないか、追加のソース MAC アドレスを受け入れることができません。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_IP_ADDRESS_ENTRIES
オフロードの開始: オフロード ターゲットは、 の SourceAddress ポインターによって参照されるソース IP アドレスにデータ構造を割り当てられなかったため、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした PATH_OFFLOAD_STATE_CONST 構造体。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_TCP_XMIT_BUFFER
オフロードの開始: オフロード ターゲットが十分な TCP 送信バッファーを割り当てられなかったため、オフロード ターゲットは、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造に関連付けられている状態をオフロードできませんでした。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_TCP_RCV_BUFFER
オフロードの開始: オフロード ターゲットが十分な TCP 受信バッファーを割り当てられなかったため、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_TCP_RCV_WINDOW
オフロードの開始: オフロード ターゲットは、 で指定された InitialRcvWnd メンバーがNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした TCP_OFFLOAD_STATE_CACHED 構造体は、オフロード ターゲットがサポートできるよりも大きくなります。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_VLAN_ENTRIES
オフロードの開始: オフロード ターゲットでは、追加の VLAN ID を追跡するためのリソースが不足しています。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_VLAN_MISMATCH
オフロードを開始する: 近隣 VlanId は 0 以外であり、インターフェイス VLAN ID の 1 つと一致しません。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NDIS_STATUS_OFFLOAD_PATH_MTU
オフロードの開始: TCP 接続のパス MTU が、オフロード ターゲットでサポートされているパスよりも大きい。
クエリ、更新、無効化、または終了オフロード: 許可されている状態値ではありません。
NdisReserved[3]
NDIS で使用するために予約されています。
OffloadHandle
NDIS_OFFLOAD_HANDLE構造体へのポインター。 NDIS_OFFLOAD_HANDLE構造体は、オフロードされた状態オブジェクトのプロトコルまたは中間ドライバーのコンテキストを表します。
ProtocolReserved[2]
この領域を独自の目的で使用できるプロトコル ドライバーで使用するために予約されています。
MiniportReserved[2]
オフロード ターゲットまたは中間ドライバーのミニポート部分で使用するために予約されています。
ImReserved[2]
中間ドライバーで使用するために予約されており、この領域を独自の目的で使用できます。
Scratch[2]
プロトコル ドライバーまたは中間ドライバーは、内部追跡にこの領域を使用できます。 この領域の情報は、ドライバーが の所有権を持っている間にのみ有効です。 NDIS_PROTOCOL_OFFLOAD_BLOCK_LIS T.
SourceHandle
このメンバーは、プロトコルまたは中間ドライバーでは重要ではありません。 プロトコルまたは中間ドライバーは、このメンバーを変更することはできません。
状態操作操作の完了を伝達すると、中間ドライバーは、
SourceHandle の SourceHandle メンバーへの IM 呼び出しエントリに格納されているNdisMXxxComplete 関数に渡す構造体をNDIS_MINIPORT_OFFLOAD_BLOCK_LISTします。
PortNumber
ミニポート アダプターのポートを識別するポート番号。 ミニポート アダプターのポート番号を割り当てるには、 NdisMAllocatePort 関数を呼び出します。 0 の値は、ミニポート アダプターの既定のポートを識別します。 ミニポート ドライバーが指定したアダプターのポートを割り当てされていない場合は、既定のポートを使用します。
NetBufferListChain
プロトコルまたは中間ドライバーで NULL 値が指定されている場合、 NetBufferListChain は重要ではなく、基になるドライバーまたはオフロード ターゲットによって無視できます。
プロトコルまたは中間ドライバーが NULL 以外の値を指定する場合、 NetBufferListChain は 、スタンドアロン構造体またはそのような構造体のリンクされたリスト内の最初の構造体を指定できる NET_BUFFER_LIST 構造体を指します。 リンク リスト内の各NET_BUFFER_LIST構造体は、1 つの NET_BUFFER 構造について説明します。 NET_BUFFER構造体は、メモリ記述子リスト (MDL) のチェーンにマップされます。 NET_BUFFER_LISTおよび関連する構造体は、物理メモリに常駐し続けることができるようにロックされます。 ただし、システム メモリにはマップされません。
NET_BUFFER構造体に関連付けられている MCL には、状態操作操作またはそのような操作の完了の一部として伝達されるデータが含まれています。 現時点では、リンク リストには、未処理の送信データという 1 種類のデータのみを含めることができます。 データの送信の詳細については、「 オフロード操作中およびオフロード後の未処理の送信データの処理」を参照してください。
オフロード ターゲットまたは中間ドライバーは、TCP 接続のオフロードを終了するときに、未処理の送信データを基になるドライバーまたはホスト スタックに渡すことができます。 この場合、オフロード ターゲットは、 を呼び出すときに NetBufferListChain メンバーに NULL 以外の値を指定します。 NdisMTerminateOffloadComplete 関数。 オフロード ターゲットが終了している TCP 接続の送信データを渡さない場合は、NetBufferListChain メンバーの NULL 値を指定します。
注釈
中間ドライバーは、 からNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体を作成します。 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST状態操作操作を伝達するときの構造体です。 タイミング中間ドライバーは、このような操作の完了を伝達するNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体を使用して、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体を構築します。
NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体の直後にメモリ内で、オフロードされる (または終了した) 状態を含む オフロード状態構造体 を使用して、オフロード、照会、更新、無効化、または終了できます。 NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体の Header の Type メンバーは、オフロード状態の種類を指定し、メモリ内のNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に従う特定のオフロード状態構造 (または構造体) を意味します。
要件
要件 | 値 |
---|---|
Header | ndischimney.h (Ndischimney.h を含む) |