NDIS_SWITCH_PORT_PROPERTY_SECURITY 結構 (ntddndis.h)

發行項
02/26/2024

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 結構。

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

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1。

Flags

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

AllowMacSpoofing

BOOLEAN 值，如果設定為 TRUE，則指定埠允許使用來源媒體訪問控制傳送封包， (MAC) 位址與其永久 MAC 位址不同。埠的永久 MAC 位址是透過物件識別符來設定， (OID) 設定 OID_SWITCH_NIC_CREATE的要求。

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，則會指定允許埠的小組故障轉移，讓埠可以使用來源媒體訪問控制來傳送封包， (MAC) 位址與其 PermanentMacAddress 不同，但等於目前連線至相同虛擬機的另一個埠所使用的 MAC 位址。埠的永久 MAC 位址是透過物件標識符來設定， (OID) 設定OID_SWITCH_NIC_CREATE OID_SWITCH_NIC_UPDATE/的要求。

DynamicIPAddressLimit

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

備註

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

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

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

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

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