NDIS_NIC_SWITCH_VF_INFO 結構 (ntddndis.h)

發行項
02/26/2024

NDIS_NIC_SWITCH_VF_INFO 結構會指定已配置於網路適配器上之PCI Express (PCIe) (VF) 的相關信息。

語法

typedef struct _NDIS_NIC_SWITCH_VF_INFO {
  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_INFO, *PNDIS_NIC_SWITCH_VF_INFO;

成員

Header

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

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

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

NDIS 6.30 的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_NIC_SWITCH_VF_INFO_REVISION_1。

Flags

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

SwitchId

指定參數標識碼的NDIS_NIC_SWITCH_ID值。交換器標識碼是介於零與網路適配器支持的交換器數目之間的整數。 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 子磁碟分區中執行的客體作業系統中公開的虛擬設備。具有 VF 網路適配器的 VM 網路適配器小組，透過 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) Requestor ID (RID) 。

備註

NDIS_NIC_SWITCH_VF_INFO 結構包含先前透過 OID_NIC_SWITCH_ALLOCATE_VF 的 OID 方法要求所建立之 VF 的相關信息。發出此 OID 要求時，會在NDIS_NIC_SWITCH_VF_INFO_ARRAY 結構內傳回一或多個NDIS_NIC_SWITCH_VF_INFO結構。

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