NDIS_SWITCH_PORT_PROPERTY_SECURITY-Struktur (ntddndis.h)

Artikel
08/07/2023

Die NDIS_SWITCH_PORT_PROPERTY_SECURITY-Struktur gibt eine Sicherheitsrichtlinieneigenschaft für einen erweiterbaren Hyper-V-Switchport an.

Syntax

typedef struct _NDIS_SWITCH_PORT_PROPERTY_SECURITY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  BOOLEAN            AllowMacSpoofing;
  BOOLEAN            AllowIeeePriorityTag;
  UINT32             VirtualSubnetId;
  BOOLEAN            AllowTeaming;
  UINT32             DynamicIPAddressLimit;
} NDIS_SWITCH_PORT_PROPERTY_SECURITY, *PNDIS_SWITCH_PORT_PROPERTY_SECURITY;

Member

Header

Typ, Revision und Größe der NDIS_SWITCH_PORT_PROPERTY_SECURITY-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Type-Member von Header muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_PORT_PROPERTY_SECURITY-Struktur anzugeben, muss der Revisionsmember von Header auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

Originalversion für NDIS 6.30 und höher.

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

Flags

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

AllowMacSpoofing

Ein BOOLEscher Wert, der bei Festlegung auf TRUE angibt, dass der Port Pakete mit einer MAC-Adresse (Source Media Access Control) senden darf, die sich von seiner permanenten MAC-Adresse unterscheidet. Die permanente MAC-Adresse des Ports wird über eine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_NIC_CREATE konfiguriert.

AllowIeeePriorityTag

Ein BOOLEscher Wert, der bei Festlegung auf TRUE angibt, dass der Port die 802.1Q-Prioritätsinformationen in der NET_BUFFER_LIST Struktur eines Pakets beibehalten muss, wenn das Paket an den Port weitergeleitet wird. Der Port muss die Prioritätsinformationen nur beibehalten, wenn der PreservePriority-Member in der NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO Union der Out-of-Band-Daten der NET_BUFFER_LIST-Struktur des Pakets festgelegt ist.

VirtualSubnetId

Ein UINT32-Wert, der die Netzwerkvirtualisierung VirtualSubnetId angibt, die für den Port konfiguriert ist. Wenn die Netzwerkvirtualisierung nicht für den Port konfiguriert ist, ist der Wert 0. Die NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO Out-of-Band-Daten des NET_BUFFER_LIST enthält die VirtualSubnetId, die mit der Virtuellen Subnetzmitgliedschaft des Datenverkehrs aufgefüllt wird.

AllowTeaming

Ein BOOLEscher Wert, der bei Festlegung auf TRUE angibt, dass das Teamingfailover für den Port zulässig ist, sodass der Port Pakete mit einer MAC-Adresse (Source Media Access Control) senden kann, die sich von der PermanentMacAddress unterscheidet, aber gleich der MAC-Adresse ist, die derzeit von einem anderen Port verwendet wird, der mit demselben virtuellen Computer verbunden ist. Die permanente MAC-Adresse des Ports wird über eine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_NIC_CREATE/OID_SWITCH_NIC_UPDATE konfiguriert.

DynamicIPAddressLimit

Ein UINT32-Wert, der die maximale Anzahl dynamischer IP-Adressen angibt, die für den Port abgerufen werden können.

Hinweise

Die NDIS_SWITCH_PORT_PROPERTY_SECURITY-Struktur wird in den folgenden OID-Satzanforderungen verwendet:

Die NDIS_SWITCH_PORT_PROPERTY_SECURITY-Struktur folgt der NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur im Puffer, der diesen OID-Set-Anforderungen zugeordnet ist. Der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diesen Puffer.

Porteigenschaften, z . B. NDIS_SWITCH_PORT_PROPERTY_SECURITY, werden von der erweiterbaren Switcherweiterung erzwungen, die als Weiterleitungserweiterung installiert ist. Dieser Erweiterungstyp erzwingt eigene Regeln für die Weiterleitung von Paketen, OIDs und status Anzeigen über den erweiterbaren Switchtreiberstapel. Pro instance eines erweiterbaren Switches kann nur eine Weiterleitungserweiterung vorhanden sein.

Weitere Informationen zu Weiterleitungserweiterungen finden Sie unter Weiterleitungserweiterungen.

Hinweis Wenn keine Weiterleitungserweiterung installiert ist, erzwingt die erweiterbare Switchschnittstelle die Porteigenschaft selbst.