NDIS_QOS_CLASSIFICATION_ELEMENT 構造体 (ntddndis.h)

[アーティクル]
02/26/2024

NDIS_QOS_CLASSIFICATION_ELEMENT構造体は、IEEE 802.1 データセンターブリッジング (DCB) インターフェイスをサポートするネットワークアダプターの NDIS サービス品質 (QoS) トラフィック分類を指定します。

各トラフィック分類では、次の指定が行われます。

エグレスパケットデータ内のデータパターンに基づく分類条件。
NDIS 6.30 以降では、分類条件は、UDP または TCP 宛先ポート、メディアアクセス制御 (MAC) EtherType などの 16 ビット値に基づいています。
エグレスパケットの処理に使用するトラフィッククラスを定義する分類 アクション 。
NDIS 6.30 以降では、分類アクションによって 802.1p の優先度レベルが指定されます。

たとえば、トラフィック分類では、宛先 TCP ポート番号 3260 (条件) のすべてのエグレスパケットに 802.1p 優先度レベル 3 (アクション) が割り当てられることを指定できます。

構文

typedef struct _NDIS_QOS_CLASSIFICATION_ELEMENT {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             ConditionSelector;
  USHORT             ConditionField;
  USHORT             ActionSelector;
  USHORT             ActionField;
} NDIS_QOS_CLASSIFICATION_ELEMENT, *PNDIS_QOS_CLASSIFICATION_ELEMENT;

メンバー

Header

NDIS_QOS_CLASSIFICATION_ELEMENT構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポートドライバーは、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_QOS_CLASSIFICATION_ELEMENTに設定する必要があります。 NDIS_QOS_CLASSIFICATION_ELEMENT構造体のバージョンを指定するには、ドライバーは Header の Revision メンバーを次の値に設定する必要があります。

NDIS_QOS_CLASSIFICATION_ELEMENT_REVISION_1

NDIS 6.30 の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_QOS_CLASSIFICATION_ELEMENT_REVISION_1] に設定します。

Flags

ミニポートドライバーがサポートする NDIS QoS トラフィック分類の状態を指定するフラグのビットごとの OR を含む ULONG 値。次のフラグが定義されています。

NDIS_QOS_CLASSIFICATION_ENFORCED_BY_MINIPORT

このフラグが設定されている場合、ミニポートドライバーは、 NDIS_QOS_CLASSIFICATION_ELEMENT 構造で指定されているトラフィック分類パラメーターを受け入れます。ドライバーがパラメーターを受け入れる場合は、パラメーターで指定されたトラフィック分類を実行するようにネットワークアダプターを構成する必要があります。

メモこのフラグは、ミニポートドライバーが OID_QOS_PARAMETERS OID メソッド要求から NDIS に返す NDIS_QOS_CLASSIFICATION_ELEMENT 構造体でのみ設定されます。

ConditionSelector

ConditionField メンバーに含まれるデータパターンの型を指定する USHORT 値。たとえば、データパターン型では、 ConditionField メンバーによって値が指定された宛先 UDP ポートを指定できます。

詳細については、「 ConditionSelector メンバーと ConditionField メンバーを設定するためのガイドライン」を参照してください。

ConditionField

ConditionSelector メンバーによって型が指定されたデータパターンを含む USHORT 値。

詳細については、「 ConditionSelector メンバーと ConditionField メンバーを設定するためのガイドライン」を参照してください。

ActionSelector

ActionField メンバーに含まれるアクションデータの種類を指定する USHORT 値。 NDIS 6.30 以降では、アクションデータ型は ConditionField メンバーによって値が指定される 802.1p 優先度レベルを指定します。

詳細については、「 ActionSelector および ActionField メンバーを設定するためのガイドライン」を参照してください。

ActionField

ActionSelector メンバーによって型が指定されたアクション値を含む USHORT 値。

詳細については、「 ActionSelector および ActionField メンバーを設定するためのガイドライン」を参照してください。

注釈

トラフィック分類では、ネットワークアダプターがエグレスパケットデータに適用する条件と アクション を指定します。アダプターは、エグレスパケットデータを検査し、一致する分類条件を見つけると、対応するアクションをエグレスパケットに適用します。

メモ NDIS 6.30 以降では、すべてのアクションは 802.1p 優先度レベルに基づいています。ただし、ネットワークアダプターは、優先順位レベルを決定した後、優先順位レベルに関連付けられている NDIS QoS トラフィッククラスのエグレスポリシーを使用する必要があります。トラフィッククラスへの優先度レベルの関連付けは、 NDIS_QOS_PARAMETERS 構造体で指定します。

NDIS_QOS_CLASSIFICATION_ELEMENT構造体は、NDIS_QOS_PARAMETERS構造体で指定された配列内の各トラフィック分類要素を指定します。この構造体は、次の OID 要求で使用されます。

OID_QOS_OPERATIONAL_PARAMETERSとOID_QOS_REMOTE_PARAMETERSの OID クエリ要求。
OID_QOS_PARAMETERSの OID メソッド要求。

ミニポートドライバーは、次の NDIS 状態を示す NDIS_QOS_CLASSIFICATION_ELEMENT 構造体の配列を含む NDIS_QOS_PARAMETERS 構造体も返します。

詳細については、「 NDIS QoS トラフィック分類」を参照してください。

ConditionSelector メンバーと ConditionField メンバーを設定するためのガイドライン

次の表では、 ConditionSelector メンバーと ConditionField メンバーの値の範囲を定義します。

ConditionSelector 値	ConditionField 値
NDIS_QOS_CONDITION_RESERVED	ConditionField メンバーは 0 に設定する必要があります。メモこの条件は、今後使用するために予約されています。
NDIS_QOS_CONDITION_DEFAULT	ConditionField メンバーは 0 に設定する必要があります。
NDIS_QOS_CONDITION_TCP_PORT	ConditionField メンバーには、16 ビットの宛先 TCP ポート値が含まれています。
NDIS_QOS_CONDITION_UDP_PORT	ConditionField メンバーには、16 ビットの宛先 UDP ポート値が含まれています。
NDIS_QOS_CONDITION_TCP_OR_UDP_PORT	ConditionField メンバーには、16 ビットの宛先 TCP または UDP ポート値が含まれています。
NDIS_QOS_CONDITION_ETHERTYPE	ConditionField メンバーには、16 ビットの IEEE EtherType 値が含まれています。メモネットワークアダプターは、EtherType を検査するためにパケットのフレームレイアウトを決定する必要があります。たとえば、EtherType フィールドの位置はイーサネット II と 802.3 フレームで異なります。
NDIS_QOS_CONDITION_NETDIRECT_PORT	ConditionField メンバーには、16 ビットの NetworkDirect ポート値が含まれています。

ConditionSelector メンバーに NDIS_QOS_CONDITION_DEFAULT の値が含まれている場合、関連付けられている分類アクションは、他の分類条件に一致しなかったすべてのエグレスパケットに適用する必要があります。 DCB コンポーネントは、 OID_QOS_PARAMETERSの OID メソッド要求を発行するときに、 ConditionSelector を NDIS_QOS_PARAMETERS 配列の最初の NDIS_QOS_CLASSIFICATION_ELEMENT 構造体でのみ NDIS_QOS_CONDITION_DEFAULT するように設定できます。

ConditionSelector メンバーに NDIS_QOS_CONDITION_NETDIRECT_PORT の値が含まれている場合、ミニポートドライバーは、NetworkDirect 接続の送信元または宛先ポートに対して ConditionField メンバーを一致させる必要があります。ミニポートドライバーが NetDirect 接続を受け入れる場合、ドライバーは ConditionField メンバーを、その接続経由で送信するすべてのパケットのソースポートと一致させる必要があります。ミニポートドライバーが NetDirect 接続を開始する場合は、 ConditionField メンバーを、その接続経由で送信するすべてのパケットの宛先ポートと一致させる必要があります。

DCB コンポーネントの詳細については、「データセンターブリッジングの NDIS QoS アーキテクチャ」を参照してください。

ActionSelector および ActionField メンバーの設定に関するガイドライン

次の表では、 ActionSelector メンバーと ActionField メンバーの値の範囲を定義します。

ActionSelector 値	ActionField 値
NDIS_QOS_ACTION_PRIORITY	ActionField メンバーには、3 ビット IEEE 802.1p 優先度レベル値が含まれています。これらの優先度レベルの詳細については、「 IEEE 802.1p 優先度レベル」を参照してください。

NDIS 6.30 以降では、トラフィック分類アクションによって、エグレスパケットが割り当てられる IEEE 802.1p 優先度レベルが定義されます。ネットワークアダプターがエグレスパケットに優先順位レベルを割り当てると、アダプターは、指定された優先度レベルに関連付けられている NDIS QoS トラフィッククラスのパラメーターも適用します。これらのパラメーターは、ネットワークアダプターがパケットを送信する方法を決定し、帯域幅の割り当てと送信選択アルゴリズム (TSA) を含みます。

NDIS QoS トラフィッククラスの詳細については、「 NDIS QoS トラフィッククラス」を参照してください。