estrutura NDIS_SWITCH_PORT_PROPERTY_SECURITY (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_SWITCH_PORT_PROPERTY_SECURITY especifica uma propriedade de política de segurança para uma porta de comutador extensível do Hyper-V.

Sintaxe

typedef struct _NDIS_SWITCH_PORT_PROPERTY_SECURITY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  BOOLEAN            AllowMacSpoofing;
  BOOLEAN            AllowIeeePriorityTag;
  UINT32             VirtualSubnetId;
  BOOLEAN            AllowTeaming;
  UINT32             DynamicIPAddressLimit;
} NDIS_SWITCH_PORT_PROPERTY_SECURITY, *PNDIS_SWITCH_PORT_PROPERTY_SECURITY;

Membros

Header

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

O membro Type de Header deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_PORT_PROPERTY_SECURITY , o membro Revision de Header deve ser definido como o seguinte valor:

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1.

Flags

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

AllowMacSpoofing

Um valor BOOLEAN que, se definido como TRUE, especifica que a porta tem permissão para enviar pacotes com um endereço MAC (controle de acesso à mídia de origem) diferente de seu endereço MAC permanente. O endereço MAC permanente da porta é configurado por meio de uma solicitação de conjunto OID (identificador de objeto) de OID_SWITCH_NIC_CREATE.

AllowIeeePriorityTag

Um valor BOOLEAN que, se definido como TRUE, especifica que a porta deve preservar as informações de prioridade de 802,1Q na estrutura de NET_BUFFER_LIST de um pacote quando o pacote é encaminhado para a porta. A porta deve preservar as informações de prioridade somente se o membro PreservePriority for definido na união NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO dos dados fora da banda da estrutura de NET_BUFFER_LIST do pacote.

VirtualSubnetId

Um valor UINT32 que especifica a virtualização de rede VirtualSubnetId configurada na porta. Se a virtualização de rede não estiver configurada na porta, o valor será 0. O NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO dados fora de banda do NET_BUFFER_LIST contém o VirtualSubnetId, que é preenchido com a associação de sub-rede virtual do tráfego.

AllowTeaming

Um valor BOOLEAN que, se definido como TRUE, especifica que o failover de agrupamento para a porta é permitido, de modo que a porta possa enviar pacotes com um endereço MAC (controle de acesso de mídia de origem) diferente de seu PermanentMacAddress, mas igual ao endereço MAC atualmente em uso por outra porta conectada à mesma máquina virtual. O endereço MAC permanente da porta é configurado por meio de uma solicitação de conjunto OID (identificador de objeto) de OID_SWITCH_NIC_CREATE/OID_SWITCH_NIC_UPDATE.

DynamicIPAddressLimit

Um valor UINT32 que especifica o número máximo de endereços IP dinâmicos que podem ser aprendidos para a porta.

Comentários

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

A estrutura NDIS_SWITCH_PORT_PROPERTY_SECURITY segue a estrutura de 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_SECURITY, 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.