共用方式為

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY結構 （ntddndis.h）

  • 發行項

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 會將 標頭Type 成員設定為 NDIS_OBJECT_TYPE_DEFAULT。 若要指定 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 結構的版本，NDIS 會將 Revision 成員 Header 設定為下列值：

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實體函式 （PF） 或指定的PCIe虛擬函式 （VF） 的 VPorts。

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。
 
只有在 旗標 成員中指定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