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 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.
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.
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.
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-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.
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.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.30 und höher. |
Kopfzeile | ntddndis.h (include Ndis.h) |
Weitere Informationen