structure NDIS_SWITCH_PORT_PROPERTY_VLAN (ntddndis.h)

Article
02/26/2024

La structure NDIS_SWITCH_PORT_PROPERTY_VLAN spécifie une propriété de stratégie de réseau local virtuel (VLAN) pour un port de commutateur extensible Hyper-V.

Syntaxe

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;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_PORT_PROPERTY_VLAN . 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_VLAN , le membre Revision de Header doit avoir la valeur suivante :

NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1.

Flags

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

OperationMode

Valeur d’énumération NDIS_SWITCH_PORT_VLAN_MODE qui spécifie le mode d’opération du VLAN.

VlanProperties

Structure qui spécifie les propriétés d’un VLAN avec un mode d’opération NdisSwitchPortVlanModeAccess ou NdisSwitchPortVlanModeTrunk. Cette structure contient les membres suivants :

VlanProperties.AccessVlanId

Valeur UINT16 qui spécifie l’identificateur VLAN pour le port de commutateur extensible qui fonctionne en mode d’accès au réseau local virtuel.

Note Ce membre est valide uniquement si le membre OperationMode est défini sur NdisSwitchPortVlanModeAccess.

VlanProperties.NativeVlanId

Valeur UINT16 qui spécifie l’identificateur VLAN pour le port de commutateur extensible qui fonctionne en mode jonction VLAN.

VlanProperties.PruneVlanIdArray[64]

Tableau d’éléments UINT64 qui spécifie des identificateurs VLAN dont les paquets sont bloqués sur un port de commutateur extensible.

Le tableau comporte 64 éléments UINT64 qui représentent 4 096 bits consécutifs. Chaque bit qui a une valeur de un spécifie un identificateur VLAN dont les paquets sont bloqués pour être envoyés ou reçus sur un port de commutateur extensible. Par exemple, si le bit 3 est défini sur un, le trafic de paquets provenant de l’identificateur VLAN trois est bloqué sur un port. De même, si le bit 64 est défini sur zéro, le trafic de paquets provenant de l’identificateur VLAN 64 n’est pas bloqué sur un port.

Note Les réseaux locaux virtuels avec des identificateurs qui mappent à une valeur de bit d’un sont toujours bloqués. Cela remplace le paramètre de bits équivalent pour l’identificateur VLAN dans le membre TrunkVlanIdArray .

VlanProperties.TrunkVlanIdArray[64]

Tableau d’éléments UINT64 qui spécifie des identificateurs VLAN dont les paquets sont autorisés sur un port de commutateur extensible.

Le tableau comporte 64 éléments UINT64 qui représentent 4 096 bits consécutifs. Chaque bit qui a une valeur de un spécifie un identificateur VLAN dont les paquets sont autorisés à être envoyés ou reçus sur un port de commutateur extensible. Par exemple, si le bit 2 est défini sur un, le trafic de paquets provenant de l’identificateur VLAN 2 est autorisé sur un port. De même, si le bit 1954 est défini sur zéro, le trafic de paquets provenant de l’identificateur VLAN 1954 n’est pas autorisé sur un port.

PvlanProperties

Structure qui spécifie les propriétés d’un VLAN avec un mode d’opération NdisSwitchPortVlanModePrivate. Cette structure contient les membres suivants :

PvlanProperties.PvlanMode

Valeur d’énumération NDIS_SWITCH_PORT_PVLAN_MODE qui spécifie le mode d’opération du PVLAN.

PvlanProperties.PrimaryVlanId

Valeur UINT16 qui spécifie l’identificateur VLAN principal pour un port de commutateur extensible.

Note Ce membre est valide uniquement si le membre PvlanMode est défini sur NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanId

Valeur UINT16 qui spécifie l’identificateur VLAN secondaire pour un port de commutateur extensible.

Note Ce membre est valide uniquement si le membre PvlanMode est défini sur NdisSwitchPortPvlanModeIsolated ou NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanIdArray[64]

Tableau d’éléments UINT64 qui spécifient les identificateurs VLAN secondaires pour un port de commutateur extensible.

Le tableau comporte 64 éléments UINT64, qui représentent 4 096 bits consécutifs. Chaque bit qui a une valeur de un spécifie un identificateur VLAN secondaire pour le port de commutateur extensible. Par exemple, si le bit 5 est défini sur un, l’identificateur de réseau virtuel secondaire est cinq. De même, si le bit 128 est défini sur zéro, 128 ne peut pas être utilisé comme identificateur VLAN secondaire.

Note Ce membre est valide uniquement si le membre PvlanMode est défini sur NdisSwitchPortPvlanModePromiscuous.

Remarques

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

La structure NDIS_SWITCH_PORT_PROPERTY_VLAN 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_VLAN, 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.