NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur (ntddndis.h)

Artikel
02/29/2024

Die NDIS_NIC_SWITCH_VF_PARAMETERS gibt die Ressourcenparameter einer PCI Express (PCIe) Virtual Function (VF) 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;

Member

Header

Typ, Revision und Größe der NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur . Dieser Member 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_PARAMETERS-Struktur anzugeben, muss der Treiber den Revisionsmember von Header auf den folgenden Wert festlegen:

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

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

Flags

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

SwitchId

Ein NDIS_NIC_SWITCH_ID Wert, der einen Switchbezeichner angibt. Dieser Wert identifiziert den Netzwerkadapterswitch, auf dem der VF zugeordnet ist.

Der Switchbezeichner ist eine ganze Zahl zwischen null und der Anzahl von Switches, die vom Netzwerkadapter unterstützt werden. 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-Netzwerkadapterswitch auf dem Netzwerkadapter. Der Wert dieses Members muss auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.

VMName

Ein NDIS_VM_NAME Wert, der den internen Namen der untergeordneten Hyper-V-Partition angibt, die an den VF angefügt ist.

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 den 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 Element 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 Mitglieder 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

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

Weitere Informationen zur SR-IOV-Schnittstelle finden Sie unter Übersicht über single root E/O Virtualization (SR-IOV).