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構造体のバージョンを示すには、Header の Revision メンバーを次のいずれかの値に設定します。
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 セット要求を使用して更新できます。
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 を含む) |