NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 構造体 (ndischimney.h)

[アーティクル]
08/07/2023

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

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造は、TCP チムニーオフロード状態ツリーの基本的な構成要素です。オフロード状態ツリーには、1 つ以上のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体を含めることができます。

構文

typedef struct _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST {
  IN NDIS_OBJECT_HEADER                Header;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *NextBlock;
#if ...
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *DependentBlockList;
#else
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
#endif
  OUT NDIS_STATUS                      Status;
  IN PVOID                             NdisReserved[2];
  IN OUT PVOID                         *MiniportOffloadContext;
  IN NDIS_HANDLE                       NdisOffloadHandle;
  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_MINIPORT_OFFLOAD_BLOCK_LIST, *PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST;

メンバー

Header

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体のヘッダー。ヘッダーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。 NDIS_OBJECT_HEADER構造体には、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体のリビジョン番号、メモリ内のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に直ちに続くオフロード状態の種類、およびヘッダーを含むNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体のサイズ (バイト単位) が含まれます。

NDIS_OBJECT_HEADER構造体の Type メンバーは、オフロード状態の種類を示し、メモリ内のNDIS_MINIPORT_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 状態情報を指定します。この状態は、TCP_OFFLOAD_STATE_CONST構造体として書式設定され、その後にTCP_OFFLOAD_STATE_CACHED構造体が続き、その後に TCP_OFFLOAD_STATE_DELEGATED 構造体が続きます。

FilterReservedOffloadState

フィルタードライバー用に予約されています。

NextBlock

ヘッダー メンバーの Type メンバーによって示されるオフロード状態レイヤー (近隣、パス、または TCP) にある次のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体へのポインター。 NextBlock ポインターを介してリンクされているNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体は、常にオフロード状態の同じレイヤーにあります。 NextBlock の値が NULL の場合、このレベルに次のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体が追加されていないことを示します。

_NDIS_MINIPORT_OFFLOAD_BLOCK_LIST

DependentBlockList

オフロード状態の依存レイヤー (オフロード状態ツリーの上位レイヤー) にあるNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体へのポインター。 TCP チムニーオフロードの場合:

近隣レイヤーのNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体の DependentBlockList メンバーは、パスレイヤーのNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体のみを指すことができます。
パスレイヤーのNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体の DependentBlockList メンバーは、TCP レイヤーのNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体のみを指すことができます。
TCP レイヤーのNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体の DependentBlockList メンバーは常に NULL です。

DependentBlockList の値が NULL の場合、依存NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体がないことを示します。

Status

オフロードの開始、クエリオフロード、更新オフロード、オフロードの無効化、オフロードの無効化、またはオフロード操作の終了の完了状態。オフロードターゲットは、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態で実行されるか、またはによって参照されます。オフロードターゲットは、操作に応じて、次のいずれかのNDIS_STATUS値を Status メンバーに書き込みます。

NDIS_STATUS_SUCCESS

オフロードの開始: オフロードターゲットは、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態と、直ちに依存するすべてのNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態を正常にオフロードしました。

クエリ、更新、無効化、または終了オフロード: オフロードターゲットは、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態または参照先の状態に対して操作を正常に実行しました。

NDIS_STATUS_OFFLOAD_PARTIAL_SUCCESS

オフロードの開始: オフロードターゲットは、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態を正常にオフロードしましたが、直ちに依存する 1 つ以上のNDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。

クエリ、更新、無効化、または終了オフロード: 許可された状態値ではありません。

NDIS_STATUS_FAILURE

オフロードの開始: オフロードターゲットは、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造に関連付けられている状態をオフロードできませんでした。エラーの原因を分類することはできません。

クエリ、更新、無効化、または終了オフロード: オフロードターゲットは、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている、または参照されている状態に対して操作を実行できませんでした。

NDIS_STATUS_RESOURCES

オフロードの開始: オフロードターゲットは、十分なホストメモリを割り当てることができなかったため、NDIS_MINIPORT_OFFLOAD_BLOCK_LIST構造体に関連付けられている状態をオフロードできませんでした。