estrutura NDIS_SWITCH_PORT_PROPERTY_VLAN (ntddndis.h)

Artigo
03/08/2023

A estrutura NDIS_SWITCH_PORT_PROPERTY_VLAN especifica uma propriedade de política VLAN (rede local virtual) para uma porta de comutador extensível do Hyper-V.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_PORT_PROPERTY_VLAN . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O membro Tipo de Cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_PORT_PROPERTY_VLAN , o membro Revision de Header deve ser definido como o seguinte valor:

NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse membro é reservado para o NDIS.

OperationMode

Um valor de enumeração NDIS_SWITCH_PORT_VLAN_MODE que especifica o modo de operação da VLAN.

VlanProperties

Uma estrutura que especifica as propriedades de uma VLAN com um modo de operação de NdisSwitchPortVlanModeAccess ou NdisSwitchPortVlanModeTrunk. Essa estrutura contém os seguintes membros:

VlanProperties.AccessVlanId

Um valor UINT16 que especifica o identificador de VLAN para a porta de comutador extensível que opera no modo de acesso VLAN.

Nota Esse membro só será válido se o membro OperationMode estiver definido como NdisSwitchPortVlanModeAccess.

VlanProperties.NativeVlanId

Um valor UINT16 que especifica o identificador de VLAN para a porta de comutador extensível que opera no modo de tronco VLAN.

VlanProperties.PruneVlanIdArray[64]

Uma matriz de elementos UINT64 que especifica identificadores de VLAN cujos pacotes são bloqueados em uma porta de comutador extensível.

A matriz tem 64 elementos UINT64 que representam 4.096 bits consecutivos. Cada bit que tem um valor de um especifica um identificador de VLAN cujos pacotes são impedidos de serem enviados ou recebidos em uma porta de comutador extensível. Por exemplo, se o bit três estiver definido como um, o tráfego de pacotes do identificador de VLAN três será bloqueado em uma porta. Da mesma forma, se o bit 64 estiver definido como zero, o tráfego de pacotes do identificador de VLAN 64 não será bloqueado em uma porta.

Nota VLANS com identificadores que mapeiam para um valor de bit de um são sempre bloqueados. Isso substitui a configuração de bit equivalente para o identificador de VLAN no membro TrunkVlanIdArray .

VlanProperties.TrunkVlanIdArray[64]

Uma matriz de elementos UINT64 que especifica identificadores de VLAN cujos pacotes são permitidos em uma porta de comutador extensível.

A matriz tem 64 elementos UINT64 que representam 4.096 bits consecutivos. Cada bit que tem um valor de um especifica um identificador de VLAN cujos pacotes têm permissão para serem enviados ou recebidos em uma porta de comutador extensível. Por exemplo, se o bit dois for definido como um, o tráfego de pacotes do identificador de VLAN dois será permitido em uma porta. Da mesma forma, se o bit 1954 estiver definido como zero, o tráfego de pacotes do identificador VLAN 1954 não será permitido em uma porta.

PvlanProperties

Uma estrutura que especifica as propriedades de uma VLAN com um modo de operação de NdisSwitchPortVlanModePrivate. Essa estrutura contém os seguintes membros:

PvlanProperties.PvlanMode

Um NDIS_SWITCH_PORT_PVLAN_MODE valor de enumeração que especifica o modo de operação da PVLAN.

PvlanProperties.PrimaryVlanId

Um valor UINT16 que especifica o identificador de VLAN primário para uma porta de comutador extensível.

Nota Esse membro só será válido se o membro PvlanMode estiver definido como NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanId

Um valor UINT16 que especifica o identificador de VLAN secundário para uma porta de comutador extensível.

Nota Esse membro só será válido se o membro PvlanMode estiver definido como NdisSwitchPortPvlanModeIsolated ou NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanIdArray[64]

Uma matriz de elementos UINT64 que especificam os identificadores de VLAN secundários para uma porta de comutador extensível.

A matriz tem 64 elementos UINT64, que representam 4096 bits consecutivos. Cada bit que tem um valor de um especifica um identificador de VLAN secundário para a porta de comutador extensível. Por exemplo, se o bit cinco estiver definido como um, o identificador de VLAN secundário será cinco. Da mesma forma, se o bit 128 estiver definido como zero, 128 não poderá ser usado como um identificador de VLAN secundário.

Nota Esse membro só será válido se o membro PvlanMode estiver definido como NdisSwitchPortPvlanModePromiscuous.

Comentários

A estrutura NDIS_SWITCH_PORT_PROPERTY_VLAN é usada nas seguintes solicitações de conjunto de OID:

A estrutura NDIS_SWITCH_PORT_PROPERTY_VLAN segue a estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS no buffer associado a essas solicitações de conjunto de OID. O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer.

As propriedades da porta, como NDIS_SWITCH_PORT_PROPERTY_VLAN, são impostas pela extensão de comutador extensível instalada como uma extensão de encaminhamento. Esse tipo de extensão impõe suas próprias regras para encaminhar pacotes, OIDs e indicações de status por meio da pilha de driver de comutador extensível. Pode haver apenas uma extensão de encaminhamento por cada instância de um comutador extensível.

Para obter mais informações sobre extensões de encaminhamento, consulte Extensões de encaminhamento.

Nota Se uma extensão de encaminhamento não estiver instalada, a interface de comutador extensível imporá a própria propriedade de porta.