NDIS_NIC_SWITCH_VPORT_INFO 結構 (ntddndis.h)

發行項
03/01/2024

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

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

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 設定的佇列組數。

佇列配對是由傳輸佇列和接收佇列所組成。透過 OID_NIC_SWITCH_CREATE_SWITCH 的 OID 方法要求建立交換器時，會設定與預設 VPort 相關聯的佇列配對。一或多個佇列組是透過 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 可以與這個 VPort 相關聯的 CPU 組號和點陣圖。

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

LookaheadSize

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

NumFilters

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

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