NDIS_SWITCH_PORT_PROPERTY_VLAN-Struktur (ntddndis.h)

Artikel
08/07/2023

Die NDIS_SWITCH_PORT_PROPERTY_VLAN-Struktur gibt eine VLAN-Richtlinieneigenschaft (Virtual Local Area Network) für einen erweiterbaren Hyper-V-Switchport an.

Syntax

typedef struct _NDIS_SWITCH_PORT_PROPERTY_VLAN {
  NDIS_OBJECT_HEADER         Header;
  ULONG                      Flags;
  NDIS_SWITCH_PORT_VLAN_MODE OperationMode;
  union {
    struct {
      UINT16 AccessVlanId;
      UINT16 NativeVlanId;
      UINT64 PruneVlanIdArray[64];
      UINT64 TrunkVlanIdArray[64];
    } VlanProperties;
    struct {
      NDIS_SWITCH_PORT_PVLAN_MODE PvlanMode;
      UINT16                      PrimaryVlanId;
      union {
        UINT16 SecondaryVlanId;
        UINT64 SecondaryVlanIdArray[64];
      };
    } PvlanProperties;
  };
} NDIS_SWITCH_PORT_PROPERTY_VLAN, *PNDIS_SWITCH_PORT_PROPERTY_VLAN;

Member

Header

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

Das Type-Element von Header muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_PORT_PROPERTY_VLAN-Struktur anzugeben, muss der Revisionsmember von Header auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1

Originalversion für NDIS 6.30 und höher.

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

Flags

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

OperationMode

Ein NDIS_SWITCH_PORT_VLAN_MODE Enumerationswert, der den Betriebsmodus des VLAN angibt.

VlanProperties

Eine Struktur, die die Eigenschaften eines VLANs mit dem Betriebsmodus NdisSwitchPortVlanModeAccess oder NdisSwitchPortVlanModeTrunk angibt. Diese Struktur enthält die folgenden Member:

VlanProperties.AccessVlanId

Ein UINT16-Wert, der den VLAN-Bezeichner für den erweiterbaren Switchport angibt, der im VLAN-Zugriffsmodus ausgeführt wird.

Hinweis Dieser Member ist nur gültig, wenn das OperationMode-Element auf NdisSwitchPortVlanModeAccess festgelegt ist.

VlanProperties.NativeVlanId

Ein UINT16-Wert, der den VLAN-Bezeichner für den erweiterbaren Switchport angibt, der im VLAN-Trunkmodus ausgeführt wird.

VlanProperties.PruneVlanIdArray[64]

Ein Array von UINT64-Elementen, das VLAN-Bezeichner angibt, deren Pakete an einem erweiterbaren Switchport blockiert werden.

Das Array verfügt über 64 UINT64-Elemente, die 4096 aufeinanderfolgende Bits darstellen. Jedes Bit mit dem Wert 1 gibt einen VLAN-Bezeichner an, dessen Pakete an einem erweiterbaren Switchport nicht gesendet oder empfangen werden können. Wenn Beispielsweise Bit 3 auf 1 festgelegt ist, wird der Paketdatenverkehr von VLAN-Id 3 an einem Port blockiert. Wenn Bit 64 auf Null festgelegt ist, wird der Paketdatenverkehr vom VLAN-Bezeichner 64 nicht an einem Port blockiert.

Hinweis VLANS mit Bezeichnern, die einem Bitwert von 1 zugeordnet sind, werden immer blockiert. Dadurch wird die entsprechende Biteinstellung für den VLAN-Bezeichner im TrunkVlanIdArray-Element überschrieben .

VlanProperties.TrunkVlanIdArray[64]

Ein Array von UINT64-Elementen, das VLAN-Bezeichner angibt, deren Pakete an einem erweiterbaren Switchport zulässig sind.

Das Array verfügt über 64 UINT64-Elemente, die 4096 aufeinanderfolgende Bits darstellen. Jedes Bit mit dem Wert 1 gibt einen VLAN-Bezeichner an, dessen Pakete an einen erweiterbaren Switchport gesendet oder empfangen werden dürfen. Wenn z. B. Bit 2 auf 1 festgelegt ist, ist der Paketdatenverkehr von VLAN-Id 2 an einem Port zulässig. Wenn Bit 1954 auf Null festgelegt ist, ist der Paketdatenverkehr vom VLAN-Bezeichner 1954 an einem Port nicht zulässig.

PvlanProperties

Eine Struktur, die die Eigenschaften eines VLANs mit dem Betriebsmodus NdisSwitchPortVlanModePrivate angibt. Diese Struktur enthält die folgenden Member:

PvlanProperties.PvlanMode

Ein NDIS_SWITCH_PORT_PVLAN_MODE Enumerationswert, der den Betriebsmodus des PVLAN angibt.

PvlanProperties.PrimaryVlanId

Ein UINT16-Wert, der den primären VLAN-Bezeichner für einen erweiterbaren Switchport angibt.

Hinweis Dieser Member ist nur gültig, wenn das PvlanMode-Element auf NdisSwitchPortPvlanModeCommunity festgelegt ist.

PvlanProperties.SecondaryVlanId

Ein UINT16-Wert, der den sekundären VLAN-Bezeichner für einen erweiterbaren Switchport angibt.

Hinweis Dieser Member ist nur gültig, wenn das PvlanMode-Element auf NdisSwitchPortPvlanModeIsolated oder NdisSwitchPortPvlanModeCommunity festgelegt ist.

PvlanProperties.SecondaryVlanIdArray[64]

Ein Array von UINT64-Elementen, die die sekundären VLAN-Bezeichner für einen erweiterbaren Switchport angeben.

Das Array verfügt über 64 UINT64-Elemente, die 4096 aufeinanderfolgende Bits darstellen. Jedes Bit mit dem Wert 1 gibt einen sekundären VLAN-Bezeichner für den erweiterbaren Switchport an. Wenn Bit fünf beispielsweise auf 1 festgelegt ist, ist der sekundäre VLAN-Bezeichner fünf. Wenn Bit 128 auf Null festgelegt ist, kann 128 nicht als sekundärer VLAN-Bezeichner verwendet werden.

Hinweis Dieser Member ist nur gültig, wenn das PvlanMode-Element auf NdisSwitchPortPvlanModePromiscuous festgelegt ist.

Hinweise

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

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

Porteigenschaften, z. B. NDIS_SWITCH_PORT_PROPERTY_VLAN, 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.