NDIS_OFFLOAD_PARAMETERS 構造体 (ntddndis.h)

[アーティクル]
03/05/2024

NDIS_OFFLOAD_PARAMETERS構造体は、OID_TCP_OFFLOAD_PARAMETERSの OID セット要求に応答して、現在のタスクオフロード構成設定を指定します。

構文

typedef struct _NDIS_OFFLOAD_PARAMETERS {
  NDIS_OBJECT_HEADER                 Header;
  UCHAR                              IPv4Checksum;
  UCHAR                              TCPIPv4Checksum;
  UCHAR                              UDPIPv4Checksum;
  UCHAR                              TCPIPv6Checksum;
  UCHAR                              UDPIPv6Checksum;
  UCHAR                              LsoV1;
  UCHAR                              IPsecV1;
  UCHAR                              LsoV2IPv4;
  UCHAR                              LsoV2IPv6;
  UCHAR                              TcpConnectionIPv4;
  UCHAR                              TcpConnectionIPv6;
  ULONG                              Flags;
  UCHAR                              IPsecV2;
  UCHAR                              IPsecV2IPv4;
  struct {
    UCHAR RscIPv4;
    UCHAR RscIPv6;
  };
  struct {
    UCHAR EncapsulatedPacketTaskOffload;
    UCHAR EncapsulationTypes;
  };
  union {
    struct {
      USHORT VxlanUDPPortNumber;
    } VxlanParameters;
    ULONG Value;
  } EncapsulationProtocolParameters;
  _ENCAPSULATION_PROTOCOL_PARAMETERS _ENCAPSULATION_PROTOCOL_PARAMETERS;
  struct {
    UCHAR IPv4;
    UCHAR IPv6;
  } UdpSegmentation;
  struct {
    UCHAR Enabled;
  } UdpRsc;
} NDIS_OFFLOAD_PARAMETERS, *PNDIS_OFFLOAD_PARAMETERS;

メンバー

Header

NDIS_OFFLOAD_PARAMETERS構造体のNDIS_OBJECT_HEADER構造体。 Header が指定する構造体の Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定します。

NDIS_OFFLOAD_PARAMETERS構造体のバージョンを示すには、Revision メンバーを次のいずれかの値に設定します。

値	意味
NDIS_OFFLOAD_PARAMETERS_REVISION_6 6	NDIS 6.89 の UdpRsc メンバーをサポートします。 [サイズ] メンバーを [NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_6] に設定します。
NDIS_OFFLOAD_PARAMETERS_REVISION_5 5	NDIS 6.83 の IPv4 および IPv6 の UdpSegmentation をサポートします。 [サイズ] メンバーを [NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_5] に設定します。
NDIS_OFFLOAD_PARAMETERS_REVISION_4 4	NDIS 6.50 のカプセル化ProtocolParameters とその入れ子になった VxlanParameters をサポートします。 [サイズ] メンバーを [NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_4] に設定します。
NDIS_OFFLOAD_PARAMETERS_REVISION_3 3	NDIS 6.30 の RscIPv4、 RscIPv6、カプセル化されたPacketTaskOffload、およびカプセル化の種類のメンバーをサポートします。 Size メンバーをNDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_3に設定します。
NDIS_OFFLOAD_PARAMETERS_REVISION_2 2	NDIS 6.1 の IPsecV2、 IPsecV2IPv4、 Reserved1、および Reserved2 メンバーをサポートします。 [サイズ] メンバーをNDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_2に設定します。
NDIS_OFFLOAD_PARAMETERS_REVISION_1 1	NDIS 6.0 の元のバージョン。 [サイズ] メンバーを [NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_1] に設定します。

IPv4Checksum

ミニポートアダプターの IPv4 チェックサム設定。詳細については、「解説」を参照してください。

TCPIPv4Checksum

TCP パケットのミニポートアダプターの IPv4 チェックサム設定。詳細については、「解説」を参照してください。

UDPIPv4Checksum

UDP パケットのミニポートアダプターの IPv4 チェックサム設定。詳細については、「解説」を参照してください。

TCPIPv6Checksum

TCP パケットのミニポートアダプターの IPv6 チェックサム設定。詳細については、「解説」を参照してください。

UDPIPv6Checksum

UDP パケットのミニポートアダプターの IPv6 チェックサム設定。詳細については、「解説」を参照してください。

LsoV1

ミニポートアダプターの大きな送信オフロードバージョン 1 (LSOV1) 設定。この設定は、次のいずれかの値である必要があります。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。
NDIS_OFFLOAD_PARAMETERS_LSOV1_DISABLED	LSOV1 は無効です。
NDIS_OFFLOAD_PARAMETERS_LSOV1_ENABLED	LSOV1 が有効になっています。

IPsecV1

ミニポートアダプターのインターネットプロトコルセキュリティ (IPsec) オフロード設定。この設定は、次のいずれかの値である必要があります。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。
NDIS_OFFLOAD_PARAMETERS_IPSECV1_DISABLED	IPsec オフロードが無効になっています。
NDIS_OFFLOAD_PARAMETERS_IPSECV1_AH_ENABLED	IPsec オフロード認証ヘッダー (AH) 機能は、送受信に対して有効にする必要があります。
NDIS_OFFLOAD_PARAMETERS_IPSECV1_ESP_ENABLED	IPsec オフロードカプセル化セキュリティペイロード (ESP) 機能は、送受信に対して有効にする必要があります。
NDIS_OFFLOAD_PARAMETERS_IPSECV1_AH_AND_ESP_ENABLED	IPsec オフロード AH および ESP 機能は、送受信に対して有効になっています。

LsoV2IPv4

ミニポートアダプターの IPv4 大送信オフロードバージョン 2 (LSOV2) 設定。この設定は、次のいずれかの値である必要があります。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。
NDIS_OFFLOAD_PARAMETERS_LSOV2_DISABLED	LSOV2 for IPv4 は無効です。
NDIS_OFFLOAD_PARAMETERS_LSOV2_ENABLED	LSOV2 for IPv4 が有効になっています。

LsoV2IPv6

ミニポートアダプターの IPv6 LSOV2 設定。これらの設定は、次のいずれかの値として指定されます。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。
NDIS_OFFLOAD_PARAMETERS_LSOV2_DISABLED	LSOV2 for IPv6 は無効になっています。
NDIS_OFFLOAD_PARAMETERS_LSOV2_ENABLED	LSOV2 for IPv6 が有効になっています。

TcpConnectionIPv4

ミニポートアダプターの IPv4 接続オフロード設定。これらの設定は、次のいずれかの値として指定されます。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。

TcpConnectionIPv6

ミニポートアダプターの IPv6 接続オフロード設定。これらの設定は、次のいずれかの値として指定されます。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。

Flags

ビットごとの OR 演算と組み合わせることができるフラグのセット。このメンバーを 0 または次の値に設定します。

値	意味
NDIS_OFFLOAD_PARAMETERS_SKIP_REGISTRY_UPDATE 0x00000001	UDP 受信セグメント結合オフロード (URO) を実行時にのみ無効にすることができます。このフラグで行われた変更はレジストリに保存されません。

IPsecV2

IPv6 と IPv4 をサポートするミニポートアダプターのインターネットプロトコルセキュリティ (IPsec) オフロードバージョン 2 の設定。このメンバーは、IPv6 と IPv4 の両方のサポートの設定を指定します。この設定は、次のいずれかの値である必要があります。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。
NDIS_OFFLOAD_PARAMETERS_IPSECV2_DISABLED	IPsec オフロードバージョン 2 は無効になっています。
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_ENABLED	IPsec オフロードバージョン 2 認証ヘッダー (AH) 機能は、送受信に対して有効にする必要があります。
NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED	IPsec オフロードバージョン 2 カプセル化セキュリティペイロード (ESP) 機能は、送受信に対して有効にする必要があります。
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED	IPsec オフロードバージョン 2 AH および ESP 機能は、送受信に対して有効になっています。

IPsecV2IPv4

IPv4 をサポートし、IPv6 をサポートしていないミニポートアダプターのインターネットプロトコルセキュリティ (IPsec) オフロードバージョン 2 の設定。ミニポートドライバーが IPv6 をサポートしている場合、 IPsecV2 メンバーは IPv4 設定を指定し、このメンバーは使用されません。この設定は、次のいずれかの値である必要があります。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。
NDIS_OFFLOAD_PARAMETERS_IPSECV2_DISABLED	IPsec オフロードバージョン 2 は無効になっています。
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_ENABLED	IPsec オフロードバージョン 2 認証ヘッダー (AH) 機能は、送受信に対して有効にする必要があります。
NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED	IPsec オフロードバージョン 2 カプセル化セキュリティペイロード (ESP) 機能は、送受信に対して有効にする必要があります。
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED	IPsec オフロードバージョン 2 AH および ESP 機能は、送受信に対して有効になっています。

RscIPv4

IPv4 の受信セグメント結合状態を示します。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	RSC の状態は変更されません。
NDIS_OFFLOAD_PARAMETERS_RSC_ENABLED	RSC 状態が有効になっています。
NDIS_OFFLOAD_PARAMETERS_RSC_DISABLED	RSC 状態は無効です。

RscIPv6

IPv6 の受信セグメント結合状態を示します。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	RSC の状態は変更されません。
NDIS_OFFLOAD_PARAMETERS_RSC_ENABLED	RSC 状態が有効になっています。
NDIS_OFFLOAD_PARAMETERS_RSC_DISABLED	RSC 状態は無効です。

EncapsulatedPacketTaskOffload

プロトコルドライバーは、 次のようにカプセル化PacketTaskOffload を 設定します。

注: VMQ や RSS などの受信側オフロードの場合、プロトコルドライバーがオフロードパラメーター (キュー、ハッシュ、間接参照テーブルなど) を有効にして構成するために送信する他のセット OID があります。 カプセル化されたPacketTaskOffload メンバーは、これらの OID の補足であり、カプセル化されたパケットに対してこれらのオフロードも行うように NIC に指示します。

値	意味
NDIS_OFFLOAD_SET_NO_CHANGE 0	NVGRE および VXLAN タスクオフロードの状態は変更されません。
NDIS_OFFLOAD_SET_ON 1	NVGRE タスクと VXLAN タスクオフロードを有効にします。
NDIS_OFFLOAD_SET_OFF 2	NVGRE および VXLAN タスクオフロードを無効にします。

EncapsulationTypes

このフィールドは、 カプセル化されたPacketTaskOffload が NDIS_OFFLOAD_SET_ONに設定されている場合にのみ有効です。 カプセル化されたPacketTaskOffload メンバーがNDIS_OFFLOAD_SET_ONに設定されていない場合、このメンバーは 0 になります。プロトコルドライバーは 、必要なカプセル化 の種類に対応するフラグのビットごとの OR にカプセル化の種類を設定する必要があります。次の中からフラグを選択できます。

値	意味
NDIS_ENCAPSULATION_TYPE_GRE_MAC 0x00000001	GRE MAC カプセル化 (NVGRE) を指定します。
NDIS_ENCAPSULATION_TYPE_VXLAN 0x00000002	VXLAN カプセル化を指定します。

EncapsulationProtocolParameters

VXLAN カプセル化のカプセル化パラメーターを記述する共用体。

ミニポートドライバーが VxlanUDPPortNumerConfigurable を TRUE としてアドバタイズした場合、プロトコルドライバーは 、EncapsulationProtocolParameters.VxlanParameters.VxlanUDPPortNumber を 0 以外の値に設定できます。ミニポートドライバーは、OID の成功後に VXLAN フレームの照合と生成にこのポート番号を使用し、その機能で更新された値もアドバタイズする必要があります。プロトコルドライバーが 0 の値を渡した場合、ミニポートドライバーは、標準化されたキーワード (keyword)から初期化されたポート番号を引き続き使用します。

EncapsulationProtocolParameters.VxlanParameters

VxlanUDPPortNumber を含む構造体。

EncapsulationProtocolParameters.VxlanParameters.VxlanUDPPortNumber

VXLAN 宛先ポート値。この値は、既定で IANA に割り当てられた値 4789 に設定されます。ミニポートドライバーは、NDIS_OFFLOAD構造でアドバタイズされた構成可能なポート番号をサポートしている場合、プロトコルドライバーは VxlanUDPPortNumber で別の値を持つNDIS_ENCAPSULATION_TYPE_VXLANを有効にするOID_TCP_OFFLOAD_PARAMETERS OID を発行できます。ミニポートドライバーは 、VxlanUDPPortNumber を使用して、受信オフロードを実行するための VXLAN カプセル化されたパケットを決定する必要があります。

EncapsulationProtocolParameters.Value

カプセル化の種類が NDIS_ENCAPSULATION_TYPE_VXLAN に設定されていない場合のポート値。

_ENCAPSULATION_PROTOCOL_PARAMETERS

EncapsulationProtocolParameters の型名。

UdpSegmentation

ミニポートアダプターの UDP セグメント化オフロード (USO) 設定を記述する構造体。

UdpSegmentation.IPv4

ミニポートアダプターの IPv4 UDP セグメント化オフロード (USO) 設定。この設定は、次のいずれかの値である必要があります。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。
NDIS_OFFLOAD_PARAMETERS_UDP_SEG_DISABLED	USO が無効になっています。
NDIS_OFFLOAD_PARAMETERS_UDP_SEG_ENABLED	USO が有効になっています。

UdpSegmentation.IPv6

ミニポートアダプターの IPv6 UDP セグメント化オフロード (USO) 設定。この設定は、次のいずれかの値である必要があります。

値	意味
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	ミニポートドライバーは、現在の設定を変更しないでください。
NDIS_OFFLOAD_PARAMETERS_UDP_SEG_DISABLED	USO が無効になっています。
NDIS_OFFLOAD_PARAMETERS_UDP_SEG_ENABLED	USO が有効になっています。

UdpRsc

ミニポートアダプターの UDP 受信セグメント結合オフロード (URO) 設定を記述する構造体。

UdpRsc.Enabled

ミニポートアダプターの URO 設定。この設定は、次のいずれかの値である必要があります。

値	意味
NDIS_OFFLOAD_PARAMETERS_UDP_RSC_NO_CHANGE 0	ミニポートドライバーは、現在の設定を変更しないでください。
NDIS_OFFLOAD_PARAMETERS_UDP_RSC_DISABLED 1	URO が無効になっています。
NDIS_OFFLOAD_PARAMETERS_UDP_RSC_ENABLED 2	URO が有効になっています。

注釈

OID_TCP_OFFLOAD_PARAMETERS OID セット要求に応答して、ミニポートドライバーは、ミニポートアダプターの現在の構成を設定するNDIS_OFFLOAD_PARAMETERS構造体の設定を使用します。

NDIS は、オフロード標準化されたキーワードのレジストリで要求された設定を保持します。 NDIS がミニポートアダプターを再起動すると、ミニポートドライバーはオフロード標準化されたキーワードを読み取り、NIC の既定のオフロード構成を設定するためにそれらを使用します。

チェックサムオフロード設定にアクセスするには、 NDIS_OFFLOAD_PARAMETERS 構造の次のメンバーを使用します。

IPv4Checksum

TCPIPv4Checksum

UDPIPv4Checksum

TCPIPv6Checksum

UDPIPv6Checksum

上記のメンバーは、次のいずれかの値を持つことができます。

NDIS_OFFLOAD_PARAMETERS_NO_CHANGE
ミニポートドライバーは、現在の設定を変更しないでください。

NDIS_OFFLOAD_PARAMETERS_TX_RX_DISABLED
メンバーが指定する機能は無効です。

NDIS_OFFLOAD_PARAMETERS_TX_ENABLED_RX_DISABLED
メンバーが指定する機能は、送信に対して有効になり、受信に対して無効になります。

NDIS_OFFLOAD_PARAMETERS_RX_ENABLED_TX_DISABLED
メンバーが指定する機能は、受信に対して有効になり、送信に対して無効になります。

NDIS_OFFLOAD_PARAMETERS_TX_RX_ENABLED
メンバーが指定する機能は、送受信に対して有効になっています。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、NDIS 6.0 以降でサポートされています。
サポートされている最小のサーバー	Windows Server 2008
Header	ntddndis.h (Ndis.h を含む)

こちらもご覧ください

NDIS_OBJECT_HEADER

OID_TCP_OFFLOAD_HARDWARE_CAPABILITIES

OID_TCP_OFFLOAD_PARAMETERS

次の方法で共有

NDIS_OFFLOAD_PARAMETERS 構造体 (ntddndis.h)

構文

メンバー

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース