NDIS_NIC_SWITCH_VPORT_PARAMETERS 結構 (ntddndis.h)

發行項
02/26/2024

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 結構。

迷你埠驅動程序必須將 Header 的 Type 成員設定為 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

此旗標指定建立 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

此旗標指定在 VPort 建立之後， 已更新 InterruptModeration 成員。您可以使用 OID_NIC_SWITCH_VPORT_PARAMETERS 的 OID 集合要求來更新此成員。

注意

只有當此結構用於 OID_NIC_SWITCH_VPORT_PARAMETERS 的 OID 集合要求時，此旗標才有效。

NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED

此旗標指定 VPortState 成員在建立 VPort 之後已更新。您可以使用 OID_NIC_SWITCH_VPORT_PARAMETERS 的 OID 集合要求來更新此成員。

注意

只有當此結構用於 OID_NIC_SWITCH_VPORT_PARAMETERS 的 OID 集合要求時，此旗標才有效。

NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED

此旗標指定在 VPort 建立之後， ProcessoryAffinity 成員已更新。只有在 VPort 附加至網路適配器上的 PF 時，才能更新 VPort 的處理器親和性。 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 的佇列數目。您可以使用 OID_NIC_SWITCH_VPORT_PARAMETERS 的 OID 集合要求來更新 NumQueuePairs 成員。

注意只有當此結構用於 OID_NIC_SWITCH_VPORT_PARAMETERS 的 OID 集合要求時，此旗標才有效。

SwitchId

NDIS_NIC_SWITCH_ID值，指定要在其中建立 VPort 之參數的標識碼。

交換器標識碼是介於零與網路適配器支持的交換器數目之間的整數。 NDIS_DEFAULT_SWITCH_ID值表示預設網路適配器交換器。

注意

從 Windows Server 2012 開始，單一根目錄 I/O 虛擬化 (SR-IOV) 介面僅支援網路適配器上的預設網路適配器交換器。這個成員的值必須設定為 NDIS_DEFAULT_SWITCH_ID。

VPortId

指定網路適配器上 VPort 識別子的NDIS_NIC_SWITCH_VPORT_ID值。此值是由 NDIS 所配置，而且在網路適配器之間是唯一的。

VPortId 值介於從零到 (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

NDIS_SRIOV_FUNCTION_ID值，指定 VPort 所連結的實體函式 (PF) 或虛擬函式 (VF) 的識別碼。 NDIS_PF_FUNCTION_ID值會指定 VPort 附加至 PF。如果值是有效的 VF 標識符，則 VPort 會附加至 VF。

NumQueuePairs

ULONG 值，指定為此 VPort 設定的佇列配對數目。

佇列配對是由傳輸佇列和接收佇列所組成。與預設 VPort 相關聯的佇列配對會在交換器建立時透過 OID_NIC_SWITCH_CREATE_SWITCH 的 OID 方法要求進行設定。一或多個佇列配對是透過 OID_NIC_SWITCH_CREATE_VPORT 的 OID 方法要求，在非預設 VPort 上設定。

InterruptModeration

指定 VPort 中斷仲裁設定的NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION 值。

VPortState

指定 VPort 目前狀態的NDIS_NIC_SWITCH_VPORT_STATE 值。

ProcessorAffinity

GROUP_AFFINITY值，指定與這個 VPort 相關聯之 CPU 的組號和點陣圖。此欄位僅適用於附加至 PF 的 VPorts。

注意

對於非預設的 PF VPorts，GROUP_AFFINITY值，指定在建立 VPort 時，只能指定一個處理器。 VPorts 是透過 OID_NIC_SWITCH_CREATE_VPORT 的 OID 方法要求來建立。

建立 VPort 之後，可以變更與附加至 PF 的非預設 VPort 相關聯的處理器親和性。您也可以使用 OID 集合要求來變更與預設 VPort 相關聯的處理器親和性 OID_NIC_SWITCH_VPORT_PARAMETERS。

LookaheadSize

這個成員保留供未來使用。這個成員必須設定為零。

NdkParams

QosSqId

將 vPort 與排程器佇列 (SQ) 產生關聯。將此欄位設定為有效的 SQ 識別碼，以將 vPort 與 SQ 產生關聯。如果沒有 SQ 關聯，請將此字段設定為零。如需 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)

另請參閱

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