NDIS_SWITCH_PORT_PROPERTY_VLAN 構造体 (ntddndis.h)

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

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 構造体として書式設定されます。

Header の Type メンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_SWITCH_PORT_PROPERTY_VLAN構造体のバージョンを指定するには、Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1

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

[サイズ] メンバーを [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

VLAN アクセスモードで動作する拡張可能スイッチポートの VLAN 識別子を指定する UINT16 値。

メモこのメンバーは、 OperationMode メンバーが NdisSwitchPortVlanModeAccess に設定されている場合にのみ有効です。

VlanProperties.NativeVlanId

VLAN トランクモードで動作する拡張可能スイッチポートの VLAN 識別子を指定する UINT16 値。

VlanProperties.PruneVlanIdArray[64]

拡張可能スイッチポートでパケットがブロックされる VLAN 識別子を指定する UINT64 要素の配列。

配列には、連続する 4096 ビットを表す 64 個の UINT64 要素があります。値が 1 の各ビットは、拡張可能スイッチポートでパケットの送受信がブロックされる VLAN 識別子を指定します。たとえば、ビット 3 が 1 に設定されている場合、VLAN 識別子 3 からのパケットトラフィックはポートでブロックされます。同様に、ビット 64 がゼロに設定されている場合、VLAN 識別子 64 からのパケットトラフィックはポートでブロックされません。

メモビット値 1 にマップされる識別子を持つ VLAN は、常にブロックされます。これにより、 TrunkVlanIdArray メンバーの VLAN 識別子に対する同等のビット設定がオーバーライドされます。

VlanProperties.TrunkVlanIdArray[64]

拡張可能スイッチポートでパケットが許可される VLAN 識別子を指定する UINT64 要素の配列。

配列には、連続する 4096 ビットを表す 64 個の UINT64 要素があります。値が 1 の各ビットは、拡張可能スイッチポートでパケットの送受信を許可される VLAN 識別子を指定します。たとえば、ビット 2 が 1 に設定されている場合、VLAN 識別子 2 からのパケットトラフィックはポートで許可されます。同様に、ビット 1954 がゼロに設定されている場合、VLAN 識別子 1954 からのパケットトラフィックはポートで許可されません。

PvlanProperties

NdisSwitchPortVlanModePrivate の操作モードを持つ VLAN のプロパティを指定する構造体。この構造体には、次のメンバーが含まれています。

PvlanProperties.PvlanMode

PVLAN の操作モードを指定する NDIS_SWITCH_PORT_PVLAN_MODE 列挙値。

PvlanProperties.PrimaryVlanId

拡張可能スイッチポートのプライマリ VLAN 識別子を指定する UINT16 値。

メモこのメンバーは、 PvlanMode メンバーが NdisSwitchPortPvlanModeCommunity に設定されている場合にのみ有効です。

PvlanProperties.SecondaryVlanId

拡張可能スイッチポートのセカンダリ VLAN 識別子を指定する UINT16 値。

メモこのメンバーは、 PvlanMode メンバーが NdisSwitchPortPvlanModeIsolated または NdisSwitchPortPvlanModeCommunity に設定されている場合にのみ有効です。

PvlanProperties.SecondaryVlanIdArray[64]

拡張可能スイッチポートのセカンダリ VLAN 識別子を指定する UINT64 要素の配列。

配列には、連続する 4096 ビットを表す 64 個の UINT64 要素があります。値が 1 の各ビットは、拡張可能スイッチポートのセカンダリ VLAN 識別子を指定します。たとえば、ビット 5 が 1 に設定されている場合、セカンダリ VLAN 識別子は 5 です。同様に、ビット 128 がゼロに設定されている場合、128 はセカンダリ VLAN 識別子として使用できません。

メモこのメンバーは、 PvlanMode メンバーが NdisSwitchPortPvlanModePromiscuous に設定されている場合にのみ有効です。

注釈

NDIS_SWITCH_PORT_PROPERTY_VLAN構造体は、次の OID セット要求で使用されます。

NDIS_SWITCH_PORT_PROPERTY_VLAN構造体は、これらの OID セット要求に関連付けられているバッファー内のNDIS_SWITCH_PORT_PROPERTY_PARAMETERS構造に従います。 NDIS_OID_REQUEST構造体の InformationBuffer メンバーには、このバッファーへのポインターが含まれています。

NDIS_SWITCH_PORT_PROPERTY_VLANなどのポートプロパティは、転送拡張機能としてインストールされている拡張可能スイッチ拡張機能によって適用されます。この種類の拡張機能では、拡張可能スイッチドライバースタックを介してパケット、OID、および状態表示を転送するための独自の規則が適用されます。拡張可能スイッチの各インスタンスごとに転送拡張機能は 1 つだけ存在できます。

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

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