NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur (ntddndis.h)
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.
VMName
Ein NDIS_VM_NAME Wert, der den internen Namen der untergeordneten Hyper-V-Partition angibt, die an den VF angefügt ist.
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).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.30 und höher. |
| Kopfzeile | ntddndis.h (include Ndis.h) |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für