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 구조체로 형식이 지정됩니다.

헤더의 Type 멤버를 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다. NDIS_SWITCH_PORT_PROPERTY_VLAN 구조체의 버전을 지정하려면 Header의 Revision 멤버를 다음 값으로 설정해야 합니다.

NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1

NDIS 6.30 이상에 대한 원래 버전입니다.

Size 멤버를 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를 0으로 설정하면 VLAN 식별자 64의 패킷 트래픽이 포트에서 차단되지 않습니다.

참고 하나의 비트 값에 매핑되는 식별자가 있는 VLAN은 항상 차단됩니다. 이렇게 하면 TrunkVlanIdArray 멤버의 VLAN 식별자에 해당하는 비트 설정이 재정의됩니다.

VlanProperties.TrunkVlanIdArray[64]

확장 가능한 스위치 포트에서 패킷이 허용되는 VLAN 식별자를 지정하는 UINT64 요소의 배열입니다.

배열에는 4096개 연속 비트를 나타내는 64개의 UINT64 요소가 있습니다. 값이 1인 각 비트는 확장 가능한 스위치 포트에서 패킷을 보내거나 받을 수 있는 VLAN 식별자를 지정합니다. 예를 들어 비트 2가 1로 설정된 경우 포트에서 VLAN 식별자 2의 패킷 트래픽이 허용됩니다. 마찬가지로 비트 1954를 0으로 설정하면 포트에서 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을 0으로 설정하면 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 및 상태 표시를 전달하기 위한 자체 규칙을 적용합니다. 확장 가능한 스위치의 각 instance당 하나의 전달 확장만 있을 수 있습니다.

확장 전달에 대한 자세한 내용은 확장 전달을 참조하세요.

참고 전달 확장이 설치되지 않은 경우 확장 가능한 스위치 인터페이스는 포트 속성 자체를 적용합니다.