NDIS_NIC_SWITCH_INFO 結構 (ntddndis.h)

發行項
02/29/2024

NDIS_NIC_SWITCH_INFO 結構會指定網路適配器上網路適配器交換器的相關信息。

語法

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

成員

Header

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

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

NDIS_NIC_SWITCH_INFO_REVISION_1

NDIS 6.30 的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1。

Flags

ULONG 值，其中包含在交換器上啟用的位 OR 組態旗標。

注意針對 NDIS 6.30，交換器不會定義任何組態旗標。 Flags 成員必須設定為零。

SwitchType

指定參數類型的 NDIS_NIC_SWITCH_TYPE 值。

SwitchId

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

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

SwitchFriendlyName

包含參數用戶易記描述的NDIS_NIC_SWITCH_FRIENDLYNAME值。

NumVFs

ULONG 值，指定網路適配器上啟用的PCI Express (PCIe) Virtual Functions () VFs 數目。已啟用的 VF 可以處於已配置或未配置的狀態。

NumAllocatedVFs

ULONG 值，指定 SwitchId 所指定網路適配器交換器上配置的 VF 數目。 VF 會透過 OID_NIC_SWITCH_ALLOCATE_VF 的 OID 集合要求來配置。

NumVPorts

ULONG 值，指定在 SwitchId 所指定的網路適配器交換器上設定的 VPorts () 虛擬埠數目。

此 ULONG 值是下列項目的總和：

可透過 OID 集合要求建立的 VPort 數目上限，OID_NIC_SWITCH_CREATE_VPORT。
附加至實體函式的預設 VPort (PF) 。

NumActiveVPorts

ULONG 值，指定 在 SwitchId 所指定的網路適配器交換器上建立的 VPort 數目。

注意除了透過 OID_NIC_SWITCH_CREATE_VPORT 的 OID 集合要求所建立的非預設 VPort 之外，這個 ULONG 值還包含預設 VPort。

NumQueuePairsForDefaultVPort

ULONG 值，指定為預設 VPort 配置的佇列組數目。默認 VPort 一律會附加至 PF。

佇列配對是由傳輸佇列和接收佇列所組成。迷你埠驅動程式會在交換器建立時，透過 OID_NIC_SWITCH_CREATE_SWITCH的 OID 方法要求，將一或多個佇列配對與預設 VPort 產生關聯。

注意從 NDIS 6.30 開始，只有一個佇列組可以針對預設 VPort 進行設定。

NumQueuePairsForNonDefaultVPorts

ULONG 值，指定為非預設 VPorts 配置的佇列組數目。非預設 VPort 可以連結至網路適配器的 PF 或任何 VF。

迷你埠驅動程式會透過 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法要求，將一或多個佇列配對與非預設 VPort 產生關聯。

NumActiveDefaultVPortMacAddresses

ULONG 值，指定目前在附加至網路適配器 PF 的預設 VPort 上設定的單播 MAC 位址篩選器數目。

NumActiveNonDefaultVPortMacAddresses

ULONG 值，指定目前在非預設 VPorts 上設定的單播 MAC 位址篩選數目。

NumActiveDefaultVPortVlanIds

ULONG 值，指定目前在預設 VPort 上設定的虛擬區域網路數目 (VLAN) 識別符篩選。

NumActiveNonDefaultVPortVlanIds

ULONG 值，指定目前在非預設 VPorts 上設定的 VLAN 識別元篩選數目。

備註

NDIS_NIC_SWITCH_INFO 結構用於 OID_NIC_SWITCH_ENUM_SWITCHES 的 OID 查詢要求中。這個 OID 要求可用來列舉網路適配器上的網路適配器交換器。發出此 OID 要求時，會在NDIS_NIC_SWITCH_INFO_ARRAY 結構內傳回一或多個NDIS_NIC_SWITCH_INFO結構。

注意從 NDIS 6.30 開始，只有描述預設網路適配器交換器資訊的 NDIS_NIC_SWITCH_INFO 會透過 OID_NIC_SWITCH_ENUM_SWITCHES 的 OID 要求傳回。

NDIS_NIC_SWITCH_INFO 結構包含先前透過 OID_NIC_SWITCH_CREATE_SWITCH 的 OID 方法要求所建立之網路適配器交換器的相關信息。

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