NDIS_NIC_SWITCH_VF_PARAMETERS Struktur (ntddndis.h)

Artikel
02/07/2025

Der NDIS_NIC_SWITCH_VF_PARAMETERS gibt die Ressourcenparameter einer VIRTUELLEN PCI-Express-Funktion (PCIe) auf einem Netzwerkadapter an.

Syntax

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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_NIC_SWITCH_VF_PARAMETERS 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_PARAMETERS-Struktur anzugeben, muss der Treiber das element RevisionHeader- auf den folgenden Wert festlegen:

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie den Size Member auf NDIS_SIZEOF_NIC_SWITCH_VF_PARAMETERS_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. Dieser Wert gibt den Netzwerkadapterschalter an, dem der VF zugeordnet ist.

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 internen Namen der Hyper-V untergeordneten Partition angibt, die an den VF angefügt ist.

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

Die NDIS_NIC_SWITCH_VF_PARAMETERS Struktur wird in OID-Methodenanforderungen von OID_NIC_SWITCH_ALLOCATE_VF und OID_NIC_SWITCH_VF_PARAMETERSverwendet.

Weitere Informationen zur SR-IOV-Schnittstelle finden Sie unter Übersicht über die Single Root I/O Virtualization (SR-IOV).