NDIS_SWITCH_PORT_PROPERTY_SECURITY 構造体 (ntddndis.h)

[アーティクル]
08/07/2023

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構造体のバージョンを指定するには、Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

NDIS 6.30 以降の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1] に設定します。

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーは NDIS 用に予約されています。

AllowMacSpoofing

TRUE に設定されている場合、ポートが永続的な MAC アドレスとは異なる送信元メディアアクセス制御 (MAC) アドレスを持つパケットの送信を許可することを指定するブール値。ポートの永続的な MAC アドレスは、 OID_SWITCH_NIC_CREATEのオブジェクト識別子 (OID) セット要求によって構成されます。

AllowIeeePriorityTag

TRUE に設定されている場合、パケットがポートに転送されるときに、ポートがパケットのNET_BUFFER_LIST構造で 802.1Q 優先度情報を保持する必要があることを指定するブール値。ポートは、PreservePriority メンバーがパケットのNET_BUFFER_LIST構造の帯域外データのNDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO共用体に設定されている場合にのみ、優先順位情報を保持する必要があります。

VirtualSubnetId

ポートで構成されているネットワーク仮想化 VirtualSubnetId を 指定する UINT32 値。ネットワーク仮想化がポートで構成されていない場合、値は 0 になります。 NET_BUFFER_LISTのNDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO帯域外データには、トラフィックの仮想サブネットメンバーシップが設定された VirtualSubnetId が含まれています。

AllowTeaming

TRUE に設定されている場合、ポートのチーミングフェールオーバーが許可されることを指定するブール値。これにより、ポートは、PermanentMacAddress とは異なるが、同じ仮想マシンに接続されている別のポートで現在使用されている MAC アドレスと同じソースメディアアクセス制御 (MAC) アドレスでパケットを送信できます。ポートの永続的な MAC アドレスは、OID_SWITCH_NIC_UPDATEのオブジェクト識別子 (OID) セット要求OID_SWITCH_NIC_CREATE/使用して構成されます。

DynamicIPAddressLimit

ポートで学習できる動的 IP アドレスの最大数を指定する UINT32 値。

注釈

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、および状態表示を転送するための独自の規則が適用されます。拡張可能スイッチの各インスタンスごとに転送拡張機能は 1 つだけ存在できます。

拡張機能の転送の詳細については、「拡張機能の転送」を参照してください。

メモ転送拡張機能がインストールされていない場合は、拡張可能スイッチインターフェイスによってポートプロパティ自体が適用されます。