NDIS_NIC_SWITCH_VF_INFO-Struktur (ntddndis.h)

Artikel
02/26/2024

Die NDIS_NIC_SWITCH_VF_INFO-Struktur gibt die Informationen zu einer PCI Express (PCIe) Virtual Function (VF) an, die dem Netzwerkadapter zugeordnet wurde.

Syntax

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;

Member

Header

Der Typ, die Revision und die Größe der NDIS_NIC_SWITCH_VF_INFO Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_NIC_SWITCH_VF_INFO-Struktur anzugeben, muss der Treiber das Revisionselement des Headers auf den folgenden Wert festlegen:

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

Ursprüngliche Version für NDIS 6.30.

Legen Sie das Element Größe auf NDIS_SIZEOF_NIC_SWITCH_VF_INFO_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Dieses Element ist für NDIS reserviert.

SwitchId

Ein NDIS_NIC_SWITCH_ID Wert, der einen Switchbezeichner angibt. Der Switch-Bezeichner ist eine ganze Zahl zwischen null und der Anzahl von Switches, die der Netzwerkadapter unterstützt. Ein NDIS_DEFAULT_SWITCH_ID-Wert gibt den Standard-Netzwerkadapterswitch an.

Hinweis Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle (Single Root E/O Virtualization) nur den Standard-Netzwerkadapterschalter auf dem Netzwerkadapter. Der Wert dieses Members muss auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.

VMName

Ein NDIS_VM_NAME Wert, der den Namen der untergeordneten Hyper-V-Partition angibt, die an die VF angefügt ist. Dieses Element enthält die benutzerfreundliche Beschreibung der Partition.

Hinweis Die untergeordnete Hyper-V-Partition wird auch als virtueller Computer (VM) bezeichnet.

VMFriendlyName

Ein NDIS_VM_FRIENDLYNAME Wert, der den externen Namen der untergeordneten Hyper-V-Partition angibt, die an die VF angefügt ist. Dieses Element enthält die benutzerfreundliche Beschreibung der Partition.

NicName

Ein NDIS_SWITCH_NIC_NAME Wert, der den Namen des Vm-Netzwerkadapters angibt. Dieses Mitglied enthält die benutzerfreundliche Beschreibung des Netzwerkadapters.

Der VM-Netzwerkadapter ist ein virtuelles Gerät, das im Gastbetriebssystem verfügbar gemacht wird, das in einer untergeordneten Hyper-V-Partition ausgeführt wird. Der VM-Netzwerkadapter verwendet den VF-Netzwerkadapter, um den hardwarebasierten VF-Datenpfad über die SR-IOV-Schnittstelle bereitzustellen.

Weitere Informationen zum VF-Datenpfad finden Sie unter SR-IOV VF-Datenpfad.

MacAddressLength

Ein USHORT-Wert, der die Länge der Member PermanentMacAddress und CurrentMacAddress angibt.

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Die permanente MAC-Adresse des VF. Dies ist die permanente MAC-Adresse für den VF-Netzwerkadapter, der im Gastbetriebssystem verfügbar gemacht wird.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Die aktuelle MAC-Adresse des VF. Dies ist die aktuelle MAC-Adresse für den VF-Netzwerkadapter, der im Gastbetriebssystem verfügbar gemacht wird.

VFId

Ein NDIS_SRIOV_FUNCTION_ID Wert, der den eindeutigen Bezeichner des VF auf dem Netzwerkadapter angibt.

RequestorId

Eine NDIS_VF_RID, die die PCI Express (PCIe) Requestor ID (RID) des VF angibt.

Hinweise

Eine NDIS_NIC_SWITCH_VF_INFO-Struktur enthält Informationen zu einer VF, die zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF erstellt wurde. Wenn diese OID-Anforderung ausgestellt wird, werden mindestens eine NDIS_NIC_SWITCH_VF_INFO-Strukturen innerhalb einer NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur zurückgegeben.

Weitere Informationen zur SR-IOV-Schnittstelle finden Sie unter Overview of Single Root E/O Virtualization (SR-IOV).