NDIS_SWITCH_PORT_PROPERTY_SECURITY estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_SWITCH_PORT_PROPERTY_SECURITY especifica uma propriedade de política de segurança para uma porta de comutador extensível 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 tipo do Header deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_SWITCH_PORT_PROPERTY_SECURITY, o membro de Revisão do 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 tamanho como NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1.

Flags

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

AllowMacSpoofing

Um valor BOOLEAN que, se definido como VERDADEIRO, especifica que a porta tem permissão para enviar pacotes com um endereço MAC (controle de acesso de 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 verdadeiro, 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 estiver definido na união NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO dos dados fora de banda da estrutura de NET_BUFFER_LIST do pacote.

VirtualSubnetId

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

AllowTeaming

Um valor BOOLEAN que, se definido como VERDADEIRO, 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.

Observações

A estrutura NDIS_SWITCH_PORT_PROPERTY_SECURITY é usada nas seguintes solicitações do 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 InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer.

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

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.