NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 結構 (ntddndis.h)

發行項
02/29/2024

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 結構會指定陣列。數位中的每個元素都會指定已在網路適配器網路適配器交換器上建立之虛擬埠 (VPort) 的屬性。

語法

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

成員

Header

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 結構的型別、修訂和大小。這個成員會格式化為 NDIS_OBJECT_HEADER 結構。

NDIS 會將 Header 的 Type 成員設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定NDIS_NIC_SWITCH_VPORT_INFO_ARRAY結構的版本，NDIS 會將 Header 的 Revision 成員設定為下列值：

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1。

Flags

包含下列旗標之位 OR 的 ULONG 值：

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

此旗標會指定列舉附加至特定PCI Express (PCIe) 函式的 VPorts。函式是在 AttachedFunctionId 成員中指定。此旗標可用來列舉附加至PCIe實體函數的 VPorts (PF) 或指定的PCIe虛擬函式 (VF) 。

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

此旗標會指定列舉在 SwitchId 所指定之特定交換器上建立的 VPorts。這會列舉在交換器上建立的所有 VPorts。

注意這些旗標互斥。旗標成員中只能設定一個旗標。

SwitchId

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

只有在 Flags 成員中指定了 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH 時，SwitchId 成員才有效。

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

AttachedFunctionId

NDIS_SRIOV_FUNCTION_ID值，指定網路適配器上 PF 或 VF 的識別碼。

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

只有在 Flags 成員中指定NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION時，AttachedFunctionId 成員才有效。

FirstElementOffset

ULONG 值，指定此結構後面元素陣列中第一個專案的位移，以位元組為單位。位移是從 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 結構的開頭到第一個元素的開頭來測量。陣列中的每個專案都是 NDIS_NIC_SWITCH_VPORT_INFO 結構。

注意如果 NumElements 設定為零，則會忽略此成員。

NumElements

ULONG 值，指定 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 結構後面的項目數目。

ElementSize

ULONG 值，指定 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY結構後面 每個元素的大小，以位元組為單位。

備註

當 NDIS 處理 OID_NIC_SWITCH_ENUM_VPORTS 的 OID 方法要求時，NDIS 會傳回 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY結構。陣列中緊接 在 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 結構後面的每個元素都是
NDIS_NIC_SWITCH_VPORT_INFO 結構。

如需 SR-IOV 介面的詳細資訊，請參閱單一根目錄 I/O 虛擬化概觀 (SR-IOV) 。

規格需求

需求	值
最低支援的用戶端	NDIS 6.30 和更新版本支援。
標頭	ntddndis.h (包含 Ndis.h)

另請參閱

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS

共用方式為