NDIS_NIC_SWITCH_VF_INFO_ARRAY 結構 (ntddndis.h)

發行項
02/27/2024

NDIS_NIC_SWITCH_VF_INFO_ARRAY 結構會指定陣列。數位中的每個元素都會指定已在網路適配器上啟用和配置的PCI Express (PCIe) 虛擬函式 (VF) 屬性。

語法

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

成員

Header

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

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1。

Flags

ULONG 值，其中包含下列旗標的位 OR：

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

如果設定此旗標，迷你埠驅動程序必須只傳回已配置於 SwitchId 成員所指定網路適配器交換器上之 VFs NDIS_NIC_SWITCH_VF_INFO 結構的數位。如需詳細資訊，請參閱＜備註＞一節。

如果 Flags 成員設定為零，迷你埠驅動程式必須針對網路適配器的每個網路適配器交換器上配置的每個 VF 傳回 NDIS_NIC_SWITCH_VF_INFO 結構的數位。

注意從 Windows Server 2012 開始，SR-IOV 介面僅支援網路適配器上的預設網路適配器交換器。因此，迷你埠驅動程序必須只針對在默認網路適配器交換器上配置的每個 VF 傳回 NDIS_NIC_SWITCH_VF_INFO 結構的陣列。

SwitchId

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

注意從 Windows Server 2012 開始，SR-IOV 介面僅支援網路適配器上建立的默認網路適配器交換器。因此，此成員必須一律設定為NDIS_DEFAULT_SWITCH_ID。

FirstElementOffset

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

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

NumElements

ULONG 值，指定 NDIS_NIC_SWITCH_VF_INFO_ARRAY 結構後面的 元素數目。

ElementSize

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

備註

當 NDIS 處理OID_NIC_SWITCH_ENUM_VFS的 OID 方法要求時，NDIS 會傳回NDIS_NIC_SWITCH_VF_INFO_ARRAY結構。在陣列中遵循 NDIS_NIC_SWITCH_VF_INFO_ARRAY 結構的每個元素都是
NDIS_NIC_SWITCH_VF_INFO 結構。