NDIS_SWITCH_PORT_PROPERTY_VLAN estrutura (ntddndis.h)

Artigo
02/07/2025

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

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 do de cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_SWITCH_PORT_PROPERTY_VLAN, o membro de Revisão do de Cabeçalho 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 tamanho como NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Este membro é reservado para 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.

Observação Este membro só será válido se o membro do OperationMode estiver definido como NdisSwitchPortVlanModeAccess.

VlanProperties.NativeVlanId

Um valor UINT16 que especifica o identificador 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 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 pacote 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 VLAN 64 não será bloqueado em uma porta.

Observação VLANS com identificadores que mapeiam para um valor de bit de um sempre são 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 pacote do identificador 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 valor de enumeração NDIS_SWITCH_PORT_PVLAN_MODE 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.

Observação Este 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.

Observação Este 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 4.096 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 for 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ão ser usados como um identificador de VLAN secundário.

Observação Este membro só será válido se o membro PvlanMode estiver definido como NdisSwitchPortPvlanModePromiscuous.

Observações

A estrutura de 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 InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer.

As propriedades de 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.

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