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.
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;
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:
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.
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.
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.
PvlanProperties.SecondaryVlanId
Ein UINT16-Wert, der den sekundären VLAN-Bezeichner für einen erweiterbaren Switchport angibt.
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.
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.
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Unterstützt in NDIS 6.30 und höher. |
Header- | ntddndis.h (include Ndis.h) |