次の方法で共有


NDIS_SWITCH_PORT_PROPERTY_VLAN 構造体 (ntddndis.h)

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

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

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 つだけ存在できます。

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

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

要件

要件
サポートされている最小のクライアント NDIS 6.30 以降でサポートされています。
Header ntddndis.h (Ndis.h を含む)

こちらもご覧ください

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS

NDIS_SWITCH_PORT_VLAN_MODE

OID_SWITCH_PORT_PROPERTY_ADD

OID_SWITCH_PORT_PROPERTY_UPDATE