NDIS_SWITCH_PORT_PROPERTY_SECURITY結構（ntddndis.h）

發行項
02/07/2025

NDIS_SWITCH_PORT_PROPERTY_SECURITY 結構會指定 Hyper-V 可延伸交換器埠的安全策略屬性。

語法

typedef struct _NDIS_SWITCH_PORT_PROPERTY_SECURITY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  BOOLEAN            AllowMacSpoofing;
  BOOLEAN            AllowIeeePriorityTag;
  UINT32             VirtualSubnetId;
  BOOLEAN            AllowTeaming;
  UINT32             DynamicIPAddressLimit;
} NDIS_SWITCH_PORT_PROPERTY_SECURITY, *PNDIS_SWITCH_PORT_PROPERTY_SECURITY;

成員

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1。

Flags

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

AllowMacSpoofing

BOOLEAN 值，如果設定為 TRUE，則指定允許埠傳送與永久 MAC 位址不同的來源媒體存取控制（MAC）位址封包。埠的永久 MAC 位址是透過 OID_SWITCH_NIC_CREATE的物件識別碼（OID）集要求來設定。

AllowIeeePriorityTag

BOOLEAN 值，如果設定為 true ，則指定當封包轉送至埠時，埠必須保留封包 NET_BUFFER_LIST 結構中的 802.1Q 優先順序資訊。只有在封包 NET_BUFFER_LIST 結構的頻外數據 NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO 聯集中設定 PreservePriority 成員時，埠才必須保留優先順序資訊。

VirtualSubnetId

UINT32 值，指定埠上設定的網路虛擬化 VirtualSubnetId。如果未在埠上設定網路虛擬化，此值會是 0。 NET_BUFFER_LIST的 NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO 頻外數據包含 VirtualSubnetId，其中會填入流量的虛擬子網成員資格。

AllowTeaming

BOOLEAN 值，如果設定為 true，則會指定允許埠的小組故障轉移，讓埠可以傳送與 PermanentMacAddress不同之來源媒體訪問控制（MAC）位址的封包，但等於另一個連線至相同虛擬機的埠目前使用的 MAC 位址。埠的永久 MAC 位址是透過 OID_SWITCH_NIC_CREATE/OID_SWITCH_NIC_UPDATE的物件識別碼（OID）集要求來設定。

DynamicIPAddressLimit

UINT32 值，指定可針對埠學習的動態IP位址數目上限。

言論

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

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

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

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

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