NDIS_NIC_SWITCH_VPORT_PARAMETERS 構造体 (ntddndis.h)

NDIS_NIC_SWITCH_VPORT_PARAMETERS構造体は、ネットワーク アダプターのネットワーク アダプター スイッチ上の仮想ポート (VPort) の構成を指定します。

構文

typedef struct _NDIS_NIC_SWITCH_VPORT_PARAMETERS {
  NDIS_OBJECT_HEADER                         Header;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  NDIS_NDK_PARAMETERS                        NdkParams;
  NDIS_QOS_SQ_ID                             QosSqId;
} NDIS_NIC_SWITCH_VPORT_PARAMETERS, *PNDIS_NIC_SWITCH_VPORT_PARAMETERS;

メンバー

Header

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

ミニポート ドライバーは、ヘッダーType メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。

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

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2

NDIS 6.50 の QosSqId フィールドを追加しました。

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

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1

NDIS 6.30 以降の元のバージョン。

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

Flags

フラグのビットごとの OR を含む ULONG 値。 このメンバーには、次のフラグが定義されています。

NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED

このフラグは将来利用するために予約されています。 ミニポート ドライバーは、このフラグを無視する必要があります。

NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED

このフラグは、VPort の作成後に Flags メンバーが更新されたことを指定します。 これらのフラグは、OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求を使用して VPort が作成された後に有効または無効にすることができます。

注意

このフラグは、この構造体が OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求で使用されている場合にのみ有効です。

NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED

このフラグは、VPort が作成された後に VPortName メンバーが更新されたことを指定します。 このメンバーは、 OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求を使用して更新できます。

注意

このフラグは、この構造体が OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求で使用されている場合にのみ有効です。

NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED

このフラグは、VPort の作成後に InterruptModeration メンバーが更新されたことを指定します。 このメンバーは、 OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求を使用して更新できます。

注意

このフラグは、この構造体が OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求で使用されている場合にのみ有効です。

NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED

このフラグは、VPort の作成後に VPortState メンバーが更新されたことを指定します。 このメンバーは、 OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求を使用して更新できます。

注意

このフラグは、この構造体が OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求で使用されている場合にのみ有効です。

NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED

このフラグは、VPort の作成後に ProcessoryAffinity メンバーが更新されたことを指定します。 VPort のプロセッサ アフィニティは、VPort がネットワーク アダプター上の PF に接続されている場合にのみ更新できます。 ProcessoryAffinity メンバーは、OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求を使用して更新できます。

注意

このフラグは、この構造体が OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求で使用されている場合にのみ有効です。

NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED

このフラグは、VPort の作成後に NumQueuePairs メンバーが更新されたことを指定します。 仮想マシンの複数キュー (VMMQ) が有効になっている場合、既定の Vport と既定以外の Vport のキューの数を更新できます。 NumQueuePairs メンバーは、OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求を使用して更新できます。

メモ このフラグは、この構造体が OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求で使用されている場合にのみ有効です。
 

SwitchId

VPort を作成するスイッチの識別子を指定するNDIS_NIC_SWITCH_ID値。

スイッチ識別子は、0 からネットワーク アダプターがサポートするスイッチの数までの整数です。 NDIS_DEFAULT_SWITCH_ID値は、既定のネットワーク アダプター スイッチを示します。

注意

Windows Server 2012以降、単一ルート I/O 仮想化 (SR-IOV) インターフェイスでは、ネットワーク アダプターの既定のネットワーク アダプター スイッチのみがサポートされます。 このメンバーの値は、NDIS_DEFAULT_SWITCH_IDに設定する必要があります。

VPortId

ネットワーク アダプター上の VPort の識別子を指定するNDIS_NIC_SWITCH_VPORT_ID値。 値は NDIS によって割り当てられ、ネットワーク アダプター全体で一意です。

VPortId の値は、0 から (NumVPorts - 1) までの範囲内です。NumVPorts は、ミニポート ドライバーがネットワーク アダプターで構成した VPort の数です。 ドライバーは、NDIS_NIC_SWITCH_INFO構造体の NumVPorts メンバーでこの番号を指定します。 ドライバーは、OID_NIC_SWITCH_ENUM_SWITCHESの OID クエリ要求を通じてこの構造体 返します。

注意

NDIS_DEFAULT_VPORT_IDの VPort 識別子は、既定の NIC スイッチの PF に接続されている既定の VPort 用に予約されています。

VPortName

VPort の名前を指定するNDIS_VPORT_NAME値。 このメンバーには、VPort のわかりやすい説明が含まれています。

AttachedFunctionId

VPort がアタッチされている物理関数 (PF) または仮想関数 (VF) の ID を指定するNDIS_SRIOV_FUNCTION_ID値。 NDIS_PF_FUNCTION_ID の値は、VPort が PF にアタッチされていることを指定します。 値が有効な VF 識別子の場合、VPort は VF にアタッチされます。

NumQueuePairs

この VPort 用に構成されたキュー ペアの数を指定する ULONG 値。

キュー ペアは、送信キューと受信キューで構成されます。 既定の VPort に関連付けられているキュー ペアは、スイッチの作成時に、 OID_NIC_SWITCH_CREATE_SWITCHの OID メソッド要求によって構成されます。 1 つ以上のキュー ペアは、OID_NIC_SWITCH_CREATE_VPORTの OID メソッド要求を介して既定 以外の VPort に構成されます。

InterruptModeration

VPort の割り込みモデレーション設定を指定する NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION 値。

VPortState

VPort 現在の状態を指定するNDIS_NIC_SWITCH_VPORT_STATE値。

ProcessorAffinity

この VPort が関連付けられている CPU のグループ番号とビットマップを指定するGROUP_AFFINITY値。 このフィールドは、PF に接続されている VPort に対してのみ有効です。

注意

既定以外の PF VPort の場合、VPort の作成時に 1 つのプロセッサのみを指定するGROUP_AFFINITY値を指定する必要があります。 VPorts は、 OID_NIC_SWITCH_CREATE_VPORTの OID メソッド要求を通じて作成されます。

PF にアタッチされている既定以外の VPort に関連付けられているプロセッサ アフィニティは、VPort の作成後に変更できます。 既定の VPort に関連付けられているプロセッサ アフィニティは、 OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求を使用して変更することもできます。

LookaheadSize

このメンバーは将来使用するために予約されています。 このメンバーは 0 に設定する必要があります。

NdkParams

QosSqId

vPort をスケジューラ キュー (SQ) に関連付けます。 このフィールドを有効な SQ ID に設定して、vPort を SQ に関連付けます。 SQ 関連付けがない場合は、このフィールドを 0 に設定します。 NDIS_QOS_SQ_IDの詳細については、「OID_QOS_OFFLOAD_CREATE_SQ」を参照してください。

注釈

この構造体は、 OID_NIC_SWITCH_CREATE_VPORTとOID_NIC_SWITCH_VPORT_PARAMETERS の OID 要求で使用 されます

SR-IOV インターフェイスの詳細については、「 単一ルート I/O 仮想化 (SR-IOV) の概要」を参照してください。

要件

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

こちらもご覧ください

NDIS_NIC_SWITCH_INFO

NDIS_NIC_SWITCH_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_ENUM_SWITCHES

OID_NIC_SWITCH_VPORT_PARAMETERS