structure NDIS_SWITCH_PORT_PROPERTY_SECURITY (ntddndis.h)

Article
08/07/2023

La structure NDIS_SWITCH_PORT_PROPERTY_SECURITY spécifie une propriété de stratégie de sécurité pour un port de commutateur extensible Hyper-V.

Syntaxe

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;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_PORT_PROPERTY_SECURITY . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le membre Type de l’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_SWITCH_PORT_PROPERTY_SECURITY , le membre Revision de Header doit avoir la valeur suivante :

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

Version d’origine pour NDIS 6.30 et versions ultérieures.

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs. Ce membre est réservé à NDIS.

AllowMacSpoofing

Valeur BOOLEAN qui, si elle est définie sur TRUE, spécifie que le port est autorisé à envoyer des paquets avec une adresse de contrôle d’accès multimédia (MAC) source différente de son adresse MAC permanente. L’adresse MAC permanente du port est configurée via une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_NIC_CREATE.

AllowIeeePriorityTag

Valeur BOOLEAN qui, si elle est définie sur TRUE, spécifie que le port doit conserver les informations de priorité 802.1Q dans la structure NET_BUFFER_LIST d’un paquet lorsque le paquet est transféré vers le port. Le port doit conserver les informations de priorité uniquement si le membre PreservePriority est défini dans l’union NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO des données hors bande de la structure NET_BUFFER_LIST du paquet.

VirtualSubnetId

Valeur UINT32 qui spécifie la virtualisation de réseau VirtualSubnetId configurée sur le port. Si la virtualisation réseau n’est pas configurée sur le port, la valeur est 0. Le NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO données hors bande du NET_BUFFER_LIST contient le VirtualSubnetId, qui est rempli avec l’appartenance au sous-réseau virtuel du trafic.

AllowTeaming

Valeur BOOLEAN qui, si elle est définie sur TRUE, spécifie que le basculement d’équipe pour le port est autorisé, de sorte que le port peut envoyer des paquets avec une adresse de contrôle d’accès multimédia (MAC) source différente de son Adresse PermanentMacAddress, mais égale à l’adresse MAC actuellement utilisée par un autre port connecté à la même machine virtuelle. L’adresse MAC permanente du port est configurée via une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_NIC_CREATE/OID_SWITCH_NIC_UPDATE.

DynamicIPAddressLimit

Valeur UINT32 qui spécifie le nombre maximal d’adresses IP dynamiques qui peuvent être apprises pour le port.

Remarques

La structure NDIS_SWITCH_PORT_PROPERTY_SECURITY est utilisée dans les demandes de jeu d’OID suivantes :

La structure NDIS_SWITCH_PORT_PROPERTY_SECURITY suit la structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS dans la mémoire tampon associée à ces demandes de jeu d’OID. Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers cette mémoire tampon.

Les propriétés de port, telles que NDIS_SWITCH_PORT_PROPERTY_SECURITY, sont appliquées par l’extension de commutateur extensible installée en tant qu’extension de transfert. Ce type d’extension applique ses propres règles pour le transfert des paquets, des OID et des indications status via la pile de pilotes de commutateur extensible. Il ne peut y avoir qu’une seule extension de transfert pour chaque instance d’un commutateur extensible.

Pour plus d’informations sur le transfert d’extensions, consultez Transfert d’extensions.

Note Si aucune extension de transfert n’est installée, l’interface de commutateur extensible applique la propriété de port elle-même.