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 構造体として書式設定されます。
ミニポート ドライバーは、ヘッダー の 型 メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。
NDIS_NIC_SWITCH_VPORT_PARAMETERS 構造体のバージョンを示すには、Header の Revision メンバーを次のいずれかの値に設定します。
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2
NDIS 6.50 の QosSqId フィールドを追加しました。
Size メンバーをNDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2に設定します。
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1
NDIS 6.30 以降の元のバージョン。
Size メンバーを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
このフラグは、Flags メンバーが VPort の作成後に更新されたことを指定します。 これらのフラグは、OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求を使用して VPort が作成された後に有効または無効にすることができます。
手記
このフラグは、この構造体が OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求で使用されている場合にのみ有効です。
NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED
このフラグは、VPortName メンバーが VPort の作成後に更新されたことを指定します。 このメンバーは、OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求を使用して更新できます。
手記
このフラグは、この構造体が OID_NIC_SWITCH_VPORT_PARAMETERSの OID セット要求で使用されている場合にのみ有効です。
NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED
このフラグは、InterruptModeration メンバーが VPort の作成後に更新されたことを指定します。 このメンバーは、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
このフラグは、NumQueuePairs メンバーが VPort の作成後に更新されたことを指定します。 仮想マシンの複数キュー (VMMQ) が有効になっている場合、既定の Vport と既定以外の Vport のキューの数を更新できます。 NumQueuePairs メンバーは、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値を指定する必要があります。 VPort は、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 |
| ヘッダー | ntddndis.h (Ndis.h を含む) |