NDIS_NIC_SWITCH_VF_PARAMETERS結構（ntddndis.h）

NDIS_NIC_SWITCH_VF_PARAMETERS 會在網路適配器上指定PCI Express （PCIe） 虛擬函式 （VF） 的資源參數。

語法

typedef struct _NDIS_NIC_SWITCH_VF_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_VM_NAME           VMName;
  NDIS_VM_FRIENDLYNAME   VMFriendlyName;
  NDIS_SWITCH_NIC_NAME   NicName;
  USHORT                 MacAddressLength;
  UCHAR                  PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                  CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_SRIOV_FUNCTION_ID VFId;
  NDIS_VF_RID            RequestorId;
} NDIS_NIC_SWITCH_VF_PARAMETERS, *PNDIS_NIC_SWITCH_VF_PARAMETERS;

成員

Header

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

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

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NIC_SWITCH_VF_PARAMETERS_REVISION_1。

Flags

包含位 OR 旗標的 ULONG 值。 此成員保留給 NDIS。

SwitchId

指定參數標識碼的NDIS_NIC_SWITCH_ID值。 此值會識別 VF 配置所在的網路適配器交換器。

交換器標識碼是介於零和網路適配器所支援之交換器數目之間的整數。 NDIS_DEFAULT_SWITCH_ID值表示預設網路適配器交換器。

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

 

VMName

NDIS_VM_NAME值，指定附加至 VF 之 Hyper-V 子分割的內部名稱。

附註 Hyper-V 子分割也稱為虛擬機 （VM）。

 

VMFriendlyName

NDIS_VM_FRIENDLYNAME值，指定附加至 VF 之 Hyper-V 子分割的外部名稱。 這個成員包含數據分割的使用者易記描述。

NicName

NDIS_SWITCH_NIC_NAME值，指定虛擬機 （VM） 網路配接器的名稱。 此成員包含網路適配器的用戶易記描述。

VM 網路適配器是在客體作系統中公開的虛擬設備，可在 Hyper-V 子磁碟分區中執行。 VM 網路適配器會與 VF 網路適配器小組，透過 SR-IOV 介面提供硬體型 VF 數據路徑。

如需 VF 資料路徑的詳細資訊，請參閱 SR-IOV VF 資料路徑。

MacAddressLength

USHORT 值，指定 PermanentMacAddress 和 CurrentMacAddress 成員的長度。

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

VF 的永久 MAC 位址。 這是客體作系統中公開之 VF 網路適配器的永久 MAC 位址。

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

VF 的目前 MAC 位址。 這是客體作系統中公開之 VF 網路適配器的目前 MAC 位址。

VFId

NDIS_SRIOV_FUNCTION_ID值，指定網路適配器上 VF 的唯一標識碼。

RequestorId

NDIS_VF_RID，指定 VF 的 PCI Express （PCIe） 要求者識別碼 （RID）。

言論

NDIS_NIC_SWITCH_VF_PARAMETERS 結構用於 OID_NIC_SWITCH_ALLOCATE_VF 和 OID_NIC_SWITCH_VF_PARAMETERS的 OID 方法要求中。

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

要求

要求	價值
最低支援的用戶端	NDIS 6.30 和更新版本支援。
標頭	ntddndis.h （包括 Ndis.h）

另請參閱

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_VF_PARAMETERS