NDIS_NIC_SWITCH_VPORT_INFO結構（ntddndis.h）

發行項
02/07/2025

NDIS_NIC_SWITCH_VPORT_INFO 結構會指定網路適配器交換器上虛擬埠（VPort）的組態。

語法

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  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;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

成員

Header

NDIS_NIC_SWITCH_VPORT_INFO 結構的型別、修訂和大小。此成員的格式為 NDIS_OBJECT_HEADER 結構。

迷你埠驅動程序必須將標頭的 Type 成員設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_NIC_SWITCH_VPORT_INFO 結構的版本，驅動程式必須將 Revision 成員 Header 設定為下列值：

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

NDIS 6.30 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1。

VPortId

NDIS_NIC_SWITCH_VPORT_ID值，可唯一識別網路適配器上的虛擬埠（VPort）。

NDIS_DEFAULT_VPORT_ID值會指定交換器上的預設 VPort。默認 VPort 一律附加至網路適配器的 PCI Express （PCIe）實體函式（PF）。

附注具有指定 VPortId 值的非預設 VPort 之前，必須透過 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法要求來建立。

Flags

包含位 OR 旗標的 ULONG 值。此成員保留給 NDIS。

SwitchId

NDIS_NIC_SWITCH_ID值，可唯一識別網路適配器上建立的網路適配器交換器。透過 VPortId 成員所識別的 VPort 會在由 SwitchId 成員指定的交換器上建立。

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

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

VPortName

NDIS_VPORT_NAME值，指定在網路適配器交換器上建立的 VPort 名稱。此成員包含 VPort 的使用者易記描述。

AttachedFunctionId

NDIS_SRIOV_FUNCTION_ID值，指定 VF 的識別碼或 VPort 所附加的 PF。

注意如果此值NDIS_PF_FUNCTION_ID，VPort 會附加至 PF。

NumQueuePairs

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

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

InterruptModeration

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

VPortState

指定 VPort 狀態的 NDIS_NIC_SWITCH_VPORT_STATE 值。

ProcessorAffinity

GROUP_AFFINITY 值，指定此 VPort 可以關聯的 CPU 組號和點陣圖。

此成員僅適用於附加至 PF 的 VPorts。此欄位對附加至 VF 的非預設 VPorts 無效。

LookaheadSize

此成員會保留供日後使用。這個成員必須設定為零。

NumFilters

ULONG 值，指定網路適配器上已設定的接收篩選器數目。

注意從 NDIS 6.30 開始，迷你埠驅動程式必須針對網路適配器上設定的目前接收篩選器數目維護計數器。每次透過 OID_RECEIVE_FILTER_SET_FILTER的 OID 集合要求設定接收篩選時，驅動程式都必須遞增計數器。每次接收篩選透過 OID_RECEIVE_FILTER_CLEAR_FILTER的 OID 集合要求清除時，驅動程式也必須遞減計數器。