NDIS_NIC_SWITCH_VF_INFO Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_NIC_SWITCH_VF_INFO-Struktur gibt die Informationen zu einer PCI Express (PCIe) Virtual Function (VF) an, die auf 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;

Angehörige

Header

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

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

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

Originalversion für NDIS 6.30.

Legen Sie den Size Member auf NDIS_SIZEOF_NIC_SWITCH_VF_INFO_REVISION_1 fest.

Flags

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

SwitchId

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

Hinweis Ab Windows Server 2012 unterstützt die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) nur den Standard-Netzwerkadapterschalter auf dem Netzwerkadapter. Der Wert dieses Elements 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 den VF angefügt ist. Dieses Mitglied enthält die benutzerfreundliche Beschreibung der Partition.

Hinweis Die Hyper-V untergeordnete 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 den VF angefügt ist. Dieses Mitglied enthält die benutzerfreundliche Beschreibung der Partition.

NicName

Ein NDIS_SWITCH_NIC_NAME Wert, der den Namen des VM-Netzwerkadapters (Virtual Machine) 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 Hyper-V untergeordneten Partition ausgeführt wird. Die VM-Netzwerkadapterteams mit dem VF-Netzwerkadapter stellen den hardwarebasierten VF-Datenpfad über die SR-IOV Schnittstelle bereit.

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

MacAddressLength

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

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Die permanente MAC-Adresse des VF. Dies ist die dauerhafte 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.

Bemerkungen

Eine NDIS_NIC_SWITCH_VF_INFO Struktur enthält Informationen zu einem VF, das zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VFerstellt wurde. Wenn diese OID-Anforderung ausgegeben 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 Übersicht über die Single Root I/O Virtualization (SR-IOV).