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 は、次のいずれかのNDIS_STATUS値を 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
オフロードの開始: オフロード ターゲットは、NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。ホスト スタックで、以外の NULLDlSourceAddress メンバーが指定されているためです。 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 呼び出しエントリに格納されている
NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMXxxComplete 関数に渡される構造体です。
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構造体に関連付けられている MDL には、状態操作操作またはそのような操作の完了の一部として伝達されるデータが含まれています。 現時点では、リンクリストには、未処理の送信データという 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構造体に続く特定のオフロード状態構造体 (または構造体) を意味します。
必要条件
要件 | 価値 |
---|---|
ヘッダー | ndischimney.h (Ndischimney.h を含む) |
関連項目
NEIGHBOR_OFFLOAD_STATE_DELEGATEDNdisInitiateOffload の
NdisInvalidateOffload の
NdisMAllocatePort の
NdisQueryOffload の
NdisUpdateOffload の
ProtocolInitiateOffloadComplete ProtocolInvalidateOffloadComplete ProtocolQueryOffloadComplete ProtocolTerminateOffloadComplete ProtocolUpdateOffloadComplete