共用方式為

NDIS_NIC_SWITCH_PARAMETERS 結構 (ntddndis.h)

  • 發行項

NDIS_NIC_SWITCH_PARAMETERS 結構會指定網路適配器上網路適配器交換器的組態參數。

語法

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

成員

Header

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

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

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NIC_SWITCH_PARAMETERS_REVISION_1。

Flags

包含旗標位 OR 的 ULONG 值。 這個成員定義了下列旗標。

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

此旗標指定 NDIS_NIC_SWITCH_PARAMETERS結構中 已更新的欄位是 SwitchName 成員。

注意 只有當此結構用於 OID_NIC_SWITCH_PARAMETERS的 OID 集合要求時，此旗標才有效。
 

SwitchType

指定網路配接器交換器類型的 NDIS_NIC_SWITCH_TYPE 列舉值。

注意從 Windows Server 2012 開始，Windows 僅支援 NdisNicSwitchTypeExternal 的切換類型。 外部交換器指定連線到此類型交換器的埠可以透過網路適配器上的實體埠來存取外部網路。 外部交換器上的預設虛擬埠 (VPort) ，可為在 Hyper-V 父分割區管理作業系統中執行的虛擬化堆疊提供外部網路連線。
 

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 數目。 透過呼叫 NdisMEnableVirtualization 來啟用虛擬化時，適配卡上會啟用 VFs。

注意 VF 必須先透過 OID_NIC_SWITCH_ALLOCATE_VF 的 OID 方法要求來配置資源，才能將 VF 附加至 Hyper-V 子分割區。
 

NdisReserved1

保留給 NDIS。

NdisReserved2

保留給 NDIS。

NdisReserved3

保留給 NDIS。

NumQueuePairsForDefaultVPort

備註

NDIS_NIC_SWITCH_PARAMETERS 結構用於 OID_NIC_SWITCH_CREATE_SWITCH 和 OID_NIC_SWITCH_PARAMETERS 的 OID 方法要求中。 這些 OID 要求會設定或查詢網路適配器交換器的組態參數。

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

規格需求

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

另請參閱

NDIS_OBJECT_HEADER

NdisMEnableVirtualization

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS