NDIS_SWITCH_NIC_PARAMETERS Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SWITCH_NIC_PARAMETERS-Struktur gibt die Konfigurationsparameter für einen Netzwerkadapter (NIC) an, der mit einem Hyper-V erweiterbaren Switchport verbunden ist.

Syntax

typedef struct _NDIS_SWITCH_NIC_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_SWITCH_NIC_NAME         NicName;
  NDIS_SWITCH_NIC_FRIENDLYNAME NicFriendlyName;
  NDIS_SWITCH_PORT_ID          PortId;
  NDIS_SWITCH_NIC_INDEX        NicIndex;
  NDIS_SWITCH_NIC_TYPE         NicType;
  NDIS_SWITCH_NIC_STATE        NicState;
  NDIS_VM_NAME                 VmName;
  NDIS_VM_FRIENDLYNAME         VmFriendlyName;
  GUID                         NetCfgInstanceId;
  ULONG                        MTU;
  USHORT                       NumaNodeId;
  UCHAR                        PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                        VMMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                        CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  BOOLEAN                      VFAssigned;
  ULONG64                      NdisReserved[2];
} NDIS_SWITCH_NIC_PARAMETERS, *PNDIS_SWITCH_NIC_PARAMETERS;

Angehörige

Header

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

Das element TypeHeader muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_NIC_PARAMETERS-Struktur anzugeben, muss das Revision Member der Header- auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_NIC_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Size Member auf NDIS_SIZEOF_NDIS_SWITCH_NIC_PARAMETERS_REVISION_1fest.

Flags

Ein ULONG--Wert, der ein bitweises ODER- von Flags enthält. Der folgende Flagwert wird definiert.

Wert	Bedeutung
NDIS_SWITCH_NIC_FLAGS_NIC_INITIALIZING	Dieses Kennzeichen wird festgelegt, wenn das OID_SWITCH_NIC_CREATE OID zum ersten Mal während der Lebensdauer eines VM-NIC-Objekts ausgegeben wird. Wenn dieses Kennzeichen festgelegt ist: Eine Hyper-V Extensible Switch-Erweiterung kann optional den Wert der MTU Member in der NDIS_SWITCH_NIC_PARAMETERS Struktur reduzieren, wenn sie die Kopfraum für die Kapselung reservieren muss, bevor der OID den Stapel nach unten übergibt. Die Erweiterung kann keine Kapselungskopf für einen anderen NIC-Typ reservieren. Die Erweiterung sollte den MTU- Wert nicht erhöhen. Dieses Flag wird nur festgelegt, wenn das NicType Member NdisSwitchNicTypeSyntheticist.

Wert

Bedeutung

NDIS_SWITCH_NIC_FLAGS_NIC_INITIALIZING

Dieses Kennzeichen wird festgelegt, wenn das OID_SWITCH_NIC_CREATE OID zum ersten Mal während der Lebensdauer eines VM-NIC-Objekts ausgegeben wird. Wenn dieses Kennzeichen festgelegt ist:

Eine Hyper-V Extensible Switch-Erweiterung kann optional den Wert der MTU Member in der NDIS_SWITCH_NIC_PARAMETERS Struktur reduzieren, wenn sie die Kopfraum für die Kapselung reservieren muss, bevor der OID den Stapel nach unten übergibt. Die Erweiterung kann keine Kapselungskopf für einen anderen NIC-Typ reservieren.
Die Erweiterung sollte den MTU- Wert nicht erhöhen.

Dieses Flag wird nur festgelegt, wenn das NicType Member NdisSwitchNicTypeSyntheticist.

NicName

Ein NDIS_SWITCH_NIC_NAME Wert, der den eindeutigen internen Namen des Netzwerkadapters angibt, der mit einem erweiterbaren Switchport verbunden ist.

Weitere Informationen finden Sie im Abschnitt "Hinweise".

NicFriendlyName

Ein NDIS_SWITCH_NIC_FRIENDLYNAME Wert, der die benutzerfreundlichen Beschreibung des Netzwerkadapters angibt.

PortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Switchports enthält, mit dem der Netzwerkadapter verbunden ist.

NicIndex

Ein NDIS_SWITCH_NIC_INDEX Wert, der den Index des Netzwerkadapters angibt, der mit dem erweiterbaren Switchport verbunden ist, der durch das PortId Member angegeben ist.

Weitere Informationen zu NDIS_SWITCH_NIC_INDEX Werten finden Sie unter Netzwerkadapterindexwerte.

NicType

Ein NDIS_SWITCH_NIC_TYPE Wert, der den Typ des Netzwerkadapters angibt, der mit einem erweiterbaren Switchport verbunden ist.

NicState

Ein NDIS_SWITCH_NIC_STATE Wert, der den aktuellen Status des Netzwerkadapters angibt.

VmName

Ein NDIS_VM_NAME Wert, der den eindeutigen internen Namen der untergeordneten Hyper-V Partition angibt, in der das Gastbetriebssystem, das den Netzwerkadapter verfügbar macht, ausgeführt wird.

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

Hinweis Dieses Element ist nur gültig, wenn das NicType Member einen Wert von NdisSwitchNicSyntheticNic oder NdisSwitchNicEmulatedNic enthält.

VmFriendlyName

NetCfgInstanceId

Ein GUID-Wert, der den NetCfgInstanceId Registrierungswert des zugrunde liegenden Netzwerkadapters angibt.

Hinweis Dieses Element ist nur gültig, wenn das NicType Member auf NdisSwitchNicTypeExternal oder NdisSwitchNicTypeInternalfestgelegt ist. NetCfgInstanceId erst gültig, nachdem der virtuelle Netzwerkadapter initialisiert wurde.

MTU

Ein ULONG- Wert, der die maximale Größe der Übertragungseinheit (MTU) in Bytes für den Netzwerkadapter angibt.

Hinweis Der Wert dieses Elements kann sich während der Lebensdauer einer VM-NIC ändern. Daher sollten Erweiterungen dieses Element der NDIS_SWITCH_NIC_PARAMETERS Struktur lesen, die mit den folgenden OIDs übergeben wird:

NumaNodeId

Ein USHORT--Wert, der den Bezeichner für den bevorzugten Nicht-Uniform Memory Access (NUMA)-Knoten einer CPU angibt. Auf Computern, die NUMA-Architektur unterstützen, ist der bevorzugte NUMA-Knoten die CPU, die den kleinsten Abstand zum Netzwerkadapter aufweist.

Note This member is valid only if the NicType member is set to NdisSwitchNicTypeSynthetic or NdisSwitchNicTypeEmulated.

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Ein UCHAR- Array, das die MAC-Adresse (Media Access Control) angibt, die auf der Hostpartition für den Netzwerkadapter konfiguriert ist. Dies kann sich von der mac-Adresse unterscheiden, die derzeit vom Netzwerkadapter verwendet wird.

VMMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Ein UCHAR Array, das die MAC-Adresse angibt, die auf dem Netzwerkadapter innerhalb der VM selbst konfiguriert ist. Das Feld ist alle Nullen für NICHT-VM-NICs. Wenn AllowMacSpoofing- (von NDIS_SWITCH_PORT_PROPERTY_SECURITY) WAHR ist, wird diese Adresse auch auf die CurrentMacAddress angewendet.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Ein UCHAR Arrays, das die MAC-Adresse angibt, die derzeit im Switch für den Netzwerkadapter verwendet wird. Wenn AllowMacSpoofing und AllowTeaming false sind, ist dieser Wert gleich PermanentMacAddress. Wenn AllowMacSpoofing- WAHR ist, ist dieser Wert gleich dem VMMacAddress. Wenn AllowTeaming- WAHR ist und das Teamoverover innerhalb der VM aufgetreten ist, entspricht die CurrentMacAddress- der MAC-Adresse, die an den Netzwerkadapter fehlgeschlagen ist, oder PermanentMacAddress, wenn kein Failover aufgetreten ist.

VFAssigned

Ein BOOLESCHER Wert, der bei Festlegung auf TRUEangibt, dass der Netzwerkadapter an eine virtuelle PCI Express-Funktion (PCIe) (VF) angeschlossen ist. Ein VF wird von einem zugrunde liegenden physischen Netzwerkadapter verfügbar gemacht, der die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) unterstützt.

Weitere Informationen finden Sie im Abschnitt "Hinweise".

Hinweis Das VFAssigned Member ist nur gültig, wenn das NicType Member einen Wert von NdisSwitchNicTypeEmulated oder NdisSwitchNicTypeSyntheticenthält. Dieses Element muss auf FALSE- festgelegt werden, wenn das NicType Member einen Wert von NdisSwitchNicTypeExternal oder NdisSwitchNicTypeInternalenthält.

NdisReserved[2]

Bemerkungen

OID-Abfrageanforderungen von OID_SWITCH_NIC_ARRAY geben eine NDIS_SWITCH_NIC_ARRAY Struktur zurück, die null oder mehr Elemente enthält. Jedes Element ist als NDIS_SWITCH_NIC_PARAMETERS Struktur formatiert.

Die NDIS_SWITCH_NIC_PARAMETERS Struktur wird auch in den folgenden OID-Anforderungen verwendet:

Hinweis Die Datentypen NDIS_SWITCH_NIC_NAME, NDIS_SWITCH_NIC_FRIENDLYNAME, NDIS_VM_NAMEund NDIS_VM_FRIENDLYNAME Datentypen werden durch die IF_COUNTED_STRING Struktur definiert. Eine durch diese Struktur definierte Zeichenfolge muss nicht null beendet werden. Die Länge der Zeichenfolge muss jedoch im Length Member dieser Struktur festgelegt werden. Wenn die Zeichenfolge null-beendet ist, darf das element Length nicht das endende Nullzeichen enthalten.

Richtlinien für die NicType und NicName Member

Basierend auf dem Wert NicType Member ist das Format des NicName Member wie folgt:

Wenn der NicType Member auf NdisSwitchNicTypeExternalfestgelegt ist, ist der Wert des NicName Member der eindeutige Instanzbezeichner (InstanceId) des physischen Netzwerkadapters, der an den externen Netzwerkadapter gebunden ist. Dieser Netzwerkadaptertyp wird im Verwaltungsbetriebssystem verfügbar gemacht, das in der übergeordneten Hyper-V Partition ausgeführt wird.
Der externe Netzwerkadapter stellt eine Verbindung mit der physischen Netzwerkschnittstelle bereit, die auf dem Host verfügbar ist. Auf den externen Netzwerkadapter kann über die Hyper-V übergeordnete Partition und alle untergeordneten Partitionen zugegriffen werden.

Hinweis Der wert InstanceId wird vom Plug and Play Manager generiert, der im Verwaltungsbetriebssystem ausgeführt wird.
Wenn der NicType Member auf NdisSwitchNicTypeInternalfestgelegt ist, ist der Wert des NicName Member der Geräteanzeigename, der den internen Netzwerkadapter identifiziert. Dieser Netzwerkadaptertyp wird im Verwaltungsbetriebssystem einer Hyper-V übergeordneten Partition verfügbar gemacht.
Auf den internen Netzwerkadapter kann über die Hyper-V übergeordnete Partition und alle untergeordneten Partitionen zugegriffen werden. Der interne Netzwerkadapter stellt jedoch keine Verbindung mit der physischen Netzwerkschnittstelle her, die auf dem Host verfügbar ist.

Hinweis Der Geräteanzeigename wird von der Hyper-V WMI-Verwaltungsebene generiert, die im Verwaltungsbetriebssystem ausgeführt wird.
Für alle anderen NicType Memberwerte wird der Wert des NicName Member dem synthetischen oder emulierten Netzwerkadapter durch die Richtlinienverwaltungsschnittstelle eindeutig zugewiesen. Diese Arten von Netzwerkadaptern werden im Gastbetriebssystem verfügbar gemacht, das ausgeführt wird, ist eine Hyper-V untergeordnete Partition.

Richtlinien für das VFAssigned Mitglied

Ein PCIe VF wird durch einen zugrunde liegenden physischen Adapter erstellt und zugewiesen, der die SR-IOV Schnittstelle unterstützt. Nachdem der PCIe VF erstellt wurde, fügt der Virtualisierungsstapel an oder weisteine Hyper-V untergeordnete Partition dem VF zu. Das Gastbetriebssystem, das in dieser Partition ausgeführt wird, macht einen virtuellen Computer (VM)-Netzwerkadapter verfügbar, der angefügt ist, oder dem zugrunde liegenden SR-IOV physischen Adapter zugewiesen zugewiesen.

Wenn das VFAssigned Member auf TRUEfestgelegt ist, werden Pakete direkt zwischen dem zugrunde liegenden SR-IOV physischen Netzwerkadapter und dem virtuellen Adapter weitergeleitet. Da der erweiterbare Switch jedoch nicht an der Paketübermittlung beteiligt ist, werden erweiterbare Switchportrichtlinien wie Zugriffssteuerungslisten (Access Control Lists, ACLs) nicht auf diese Pakete angewendet.

Die Erweiterung kann eine VF-Zuordnung entfernen, indem sie eine NDIS_STATUS_SWITCH_PORT_REMOVE_VF Statusanzeige ausgibt. Diese Angabe bewirkt, dass die Pakete über einen erweiterbaren Switchport statt direkt zwischen dem VM-Netzwerkadapter und dem SR-IOV physischen Adapter übermittelt werden. Dadurch können die erweiterbaren Switchportrichtlinien auf Pakete angewendet werden, die empfangen oder über den erweiterbaren Switchport gesendet werden. Wenn die Erweiterung die NDIS_STATUS_SWITCH_PORT_REMOVE_VF Statusanzeige macht, gibt sie an, mit welchem erweiterbaren Switchport der virtuelle Netzwerkadapter verbunden ist.

Weitere Informationen finden Sie unter NDIS_STATUS_SWITCH_PORT_REMOVE_VF.