NDIS_SWITCH_PORT_PROPERTY_VLAN結構（ntddndis.h）

發行項
02/07/2025

NDIS_SWITCH_PORT_PROPERTY_VLAN 結構會指定 Hyper-V 可延伸交換器埠的虛擬局域網路（VLAN）原則屬性。

語法

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

NDIS_SWITCH_PORT_PROPERTY_VLAN 結構的型別、修訂和大小。此成員的格式為 NDIS_OBJECT_HEADER 結構。

標頭的 Type 成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SWITCH_PORT_PROPERTY_VLAN 結構的版本，Revision member of Header 必須設定為下列值：

NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1

NDIS 6.30 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1。

Flags

包含位 OR 旗標的 ULONG 值。此成員保留給 NDIS。

OperationMode

指定 VLAN 作業模式的 NDIS_SWITCH_PORT_VLAN_MODE 列舉值。

VlanProperties

結構，指定具有 NdisSwitchPortVlanModeAccess 或 NdisSwitchPortVlanModeTrunk作業模式之 VLAN 的屬性。此結構包含下列成員：

VlanProperties.AccessVlanId

UINT16 值，指定在 VLAN 存取模式中運作之可延伸交換器埠的 VLAN 識別符。

注意只有在 OperationMode 成員設定為 NdisSwitchPortVlanModeAccess時，這個成員才有效。

VlanProperties.NativeVlanId

UINT16 值，指定 VLAN 主幹模式中運作之可延伸交換器埠的 VLAN 識別符。

VlanProperties.PruneVlanIdArray[64]

UINT64 項目的陣列，指定其封包封鎖在可延伸交換器埠上的 VLAN 識別碼。

陣列有 64 個 UINT64 元素，代表 4096 個連續位。每個具有值之位都會指定 VLAN 標識符，其封包被封鎖在可延伸交換器埠上傳送或接收。例如，如果位三設為一，則來自 VLAN 標識碼 3 的封包流量會封鎖在埠上。同樣地，如果位 64 設定為零，則埠上不會封鎖來自 VLAN 標識碼 64 的封包流量。

附註對應至某個位值的標識碼的 VLANS 一律會遭到封鎖。這會覆寫 TrunkVlanIdArray 成員中 VLAN 標識符的對等位設定。

VlanProperties.TrunkVlanIdArray[64]

UINT64 項目的數位，指定允許在可延伸交換器埠上封包的 VLAN 識別碼。

陣列有 64 個 UINT64 元素，代表 4096 個連續位。每個位都有一個值，指定允許在可延伸交換器埠上傳送或接收封包的 VLAN 識別碼。例如，如果位二設定為一，則埠上允許來自 VLAN 標識碼 2 的封包流量。同樣地，如果位 1954 設定為零，則埠上不允許來自 VLAN 標識碼 1954 的封包流量。

PvlanProperties

結構，指定具有 NdisSwitchPortVlanModePrivate作業模式之 VLAN 的屬性。此結構包含下列成員：

PvlanProperties.PvlanMode

指定 PVLAN 作業模式的 NDIS_SWITCH_PORT_PVLAN_MODE 列舉值。

PvlanProperties.PrimaryVlanId

UINT16 值，指定可延伸交換器埠的主要 VLAN 識別碼。

注意只有當 PvlanMode 成員設定為 NdisSwitchPortPvlanModeCommunity時，這個成員才有效。

PvlanProperties.SecondaryVlanId

UINT16 值，指定可延伸交換器埠的次要 VLAN 識別碼。

注意只有在 PvlanMode 成員設定為 NdisSwitchPortPvlanModeIsolated 或 NdisSwitchPortPvlanModeCommunity時才有效。

PvlanProperties.SecondaryVlanIdArray[64]

UINT64 專案的陣列，指定可延伸交換器埠的次要 VLAN 識別碼。

陣列有 64 個 UINT64 元素，代表 4096 個連續位。每個位都有一個值，指定可延伸交換器埠的次要 VLAN 識別碼。例如，如果位五設定為一，則次要 VLAN 標識元為五。同樣地，如果位 128 設定為零，則 128 不能當做次要 VLAN 標識碼使用。

注意只有在 PvlanMode 成員設定為 NdisSwitchPortPvlanModePromiscuous時，這個成員才有效。

言論

NDIS_SWITCH_PORT_PROPERTY_VLAN 結構用於下列 OID 集合要求：

NDIS_SWITCH_PORT_PROPERTY_VLAN 結構會遵循與這些 OID 集合要求相關聯的緩衝區中 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 結構。 InformationBufferNDIS_OID_REQUEST 結構的成員包含這個緩衝區的指標。

埠屬性，例如 NDIS_SWITCH_PORT_PROPERTY_VLAN，是由安裝為轉送延伸模組的可延伸交換器延伸模組強制執行。這種類型的擴充功能會透過可延伸的交換器驅動程式堆疊強制執行自己的規則，以轉送封包、OID 和狀態指示。每個可延伸交換器實例只能有一個轉送延伸模組。

如需轉送延伸模組的詳細資訊，請參閱轉送延伸模組。

注意如果未安裝轉送延伸模組，可延伸交換器介面會強制執行埠屬性本身。