Auf Englisch lesen

Freigeben über


NDIS_SWITCH_PORT_PROPERTY_VLAN Struktur (ntddndis.h)

Die NDIS_SWITCH_PORT_PROPERTY_VLAN-Struktur gibt eine VLAN-Richtlinieneigenschaft (Virtual Local Area Network) für einen Hyper-V erweiterbaren 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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SWITCH_PORT_PROPERTY_VLAN 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_PORT_PROPERTY_VLAN Struktur anzugeben, muss das element RevisionHeader- 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 Size Member auf NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Dieses Mitglied 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 VLAN mit einem Betriebsmodus von NdisSwitchPortVlanModeAccess oder NdisSwitchPortVlanModeTrunkangibt. Diese Struktur enthält die folgenden Elemente:

VlanProperties.AccessVlanId

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

Hinweis Dieses Element ist nur gültig, wenn das OperationMode Member auf NdisSwitchPortVlanModeAccessfestgelegt 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-IDs angibt, deren Pakete an einem erweiterbaren Switchport blockiert sind.

Das Array verfügt über 64 UINT64-Elemente, die 4096 aufeinander folgende Bits darstellen. Jedes Bit, das einen Wert von 1 aufweist, gibt einen VLAN-Bezeichner an, dessen Pakete für das Senden oder Empfangen eines erweiterbaren Switchports blockiert werden. Wenn Beispielsweise Bit 3 auf eins festgelegt ist, wird der Paketdatenverkehr von VLAN-IDs 3 für einen Port blockiert. Wenn Bit 64 auf Null festgelegt ist, wird der Paketdatenverkehr vom VLAN-Bezeichner 64 für einen Port nicht blockiert.

Note VLANS with identifiers that map to a bit value of one are always blocked. Dadurch wird die entsprechende Biteinstellung für den VLAN-Bezeichner im TrunkVlanIdArray Member außer Kraft gesetzt.
 

VlanProperties.TrunkVlanIdArray[64]

Ein Array von UINT64-Elementen, das VLAN-IDs angibt, deren Pakete für einen erweiterbaren Switchport zulässig sind.

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

PvlanProperties

Eine Struktur, die die Eigenschaften eines VLAN mit einem Betriebsmodus von NdisSwitchPortVlanModePrivateangibt. Diese Struktur enthält die folgenden Elemente:

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 Dieses Mitglied ist nur gültig, wenn das PvlanMode Member auf NdisSwitchPortPvlanModeCommunityfestgelegt ist.
 

PvlanProperties.SecondaryVlanId

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

Hinweis Dieses Element ist nur gültig, wenn der PvlanMode- Member auf NdisSwitchPortPvlanModeIsolated oder NdisSwitchPortPvlanModeCommunityfestgelegt ist.
 

PvlanProperties.SecondaryVlanIdArray[64]

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

Das Array verfügt über 64 UINT64-Elemente, die 4096 aufeinander folgende Bits darstellen. Jedes Bit mit einem Wert von 1 gibt einen sekundären VLAN-Bezeichner für den erweiterbaren Switchport an. Wenn bit fünf beispielsweise auf eins 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 Dieses Element ist nur gültig, wenn das PvlanMode Member auf NdisSwitchPortPvlanModePromiscuousfestgelegt ist.
 

Bemerkungen

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

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

Porteigenschaften wie NDIS_SWITCH_PORT_PROPERTY_VLANwerden von der erweiterbaren Switcherweiterung erzwungen, die als Weiterleitungserweiterung installiert ist. Diese Erweiterungsart erzwingt ihre eigenen Regeln für die Weiterleitung von Paketen, OIDs und Statusanzeigen über den erweiterbaren Switchtreiberstapel. Pro Instanz eines erweiterbaren Switches kann nur eine Weiterleitungserweiterung vorhanden sein.

Weitere Informationen zu Weiterleitungserweiterungen finden Sie unter Forwarding Extensions.

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Unterstützt in NDIS 6.30 und höher.
Header- ntddndis.h (include Ndis.h)

Siehe auch

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS

NDIS_SWITCH_PORT_VLAN_MODE

OID_SWITCH_PORT_PROPERTY_ADD

OID_SWITCH_PORT_PROPERTY_UPDATE