estructura NDIS_SWITCH_PORT_PROPERTY_VLAN (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_SWITCH_PORT_PROPERTY_VLAN especifica una propiedad de directiva de red de área local virtual (VLAN) para un puerto de conmutador extensible de Hyper-V.

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructura de NDIS_SWITCH_PORT_PROPERTY_VLAN . Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .

El miembro Type de Header debe establecerse en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_SWITCH_PORT_PROPERTY_VLAN , el miembro Revision de Header debe establecerse en el siguiente valor:

NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1.

Flags

Valor ULONG que contiene un OR bit a bit de marcas. Este miembro está reservado para NDIS.

OperationMode

Valor de enumeración NDIS_SWITCH_PORT_VLAN_MODE que especifica el modo de operación de la VLAN.

VlanProperties

Estructura que especifica las propiedades de una VLAN con un modo de operación de NdisSwitchPortVlanModeAccess o NdisSwitchPortVlanModeTrunk. Esta estructura contiene los siguientes miembros:

VlanProperties.AccessVlanId

Valor UINT16 que especifica el identificador de VLAN para el puerto de conmutador extensible que funciona en modo de acceso VLAN.

Nota Este miembro solo es válido si el miembro OperationMode está establecido en NdisSwitchPortVlanModeAccess.

VlanProperties.NativeVlanId

Valor UINT16 que especifica el identificador de VLAN para el puerto de conmutador extensible que funciona en modo de tronco VLAN.

VlanProperties.PruneVlanIdArray[64]

Matriz de elementos UINT64 que especifica identificadores de VLAN cuyos paquetes están bloqueados en un puerto de conmutador extensible.

La matriz tiene 64 elementos UINT64 que representan 4096 bits consecutivos. Cada bit que tiene un valor de uno especifica un identificador de VLAN cuyos paquetes están bloqueados para enviarse o recibirse en un puerto de conmutador extensible. Por ejemplo, si el bit tres se establece en uno, el tráfico de paquetes del identificador VLAN tres se bloquea en un puerto. Del mismo modo, si el bit 64 está establecido en cero, el tráfico de paquetes del identificador 64 de VLAN no se bloquea en un puerto.

Nota Las VLAN con identificadores que se asignan a un valor de bit de uno siempre se bloquean. Esto invalida la configuración de bits equivalente para el identificador de VLAN en el miembro TrunkVlanIdArray .

VlanProperties.TrunkVlanIdArray[64]

Matriz de elementos UINT64 que especifica identificadores de VLAN cuyos paquetes se permiten en un puerto de conmutador extensible.

La matriz tiene 64 elementos UINT64 que representan 4096 bits consecutivos. Cada bit que tiene un valor de uno especifica un identificador de VLAN cuyos paquetes se pueden enviar o recibir en un puerto de conmutador extensible. Por ejemplo, si el bit dos se establece en uno, se permite el tráfico de paquetes del identificador VLAN dos en un puerto. Del mismo modo, si el bit 1954 se establece en cero, no se permite el tráfico de paquetes desde el identificador de VLAN 1954 en un puerto.

PvlanProperties

Estructura que especifica las propiedades de una VLAN con un modo de operación de NdisSwitchPortVlanModePrivate. Esta estructura contiene los siguientes miembros:

PvlanProperties.PvlanMode

Valor de enumeración NDIS_SWITCH_PORT_PVLAN_MODE que especifica el modo de operación del PVLAN.

PvlanProperties.PrimaryVlanId

Valor UINT16 que especifica el identificador de VLAN principal para un puerto de conmutador extensible.

Nota Este miembro solo es válido si el miembro PvlanMode está establecido en NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanId

Valor UINT16 que especifica el identificador de VLAN secundario para un puerto de conmutador extensible.

Nota Este miembro solo es válido si el miembro PvlanMode está establecido en NdisSwitchPortPvlanModeIsolated o NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanIdArray[64]

Matriz de elementos UINT64 que especifican los identificadores VLAN secundarios para un puerto de conmutador extensible.

La matriz tiene 64 elementos UINT64, que representan 4096 bits consecutivos. Cada bit que tiene un valor de uno especifica un identificador VLAN secundario para el puerto de conmutador extensible. Por ejemplo, si el bit cinco se establece en uno, el identificador de VLAN secundario es cinco. Del mismo modo, si el bit 128 se establece en cero, no se puede usar 128 como identificador de VLAN secundario.

Nota Este miembro solo es válido si el miembro PvlanMode está establecido en NdisSwitchPortPvlanModePromiscuous.

Comentarios

La estructura NDIS_SWITCH_PORT_PROPERTY_VLAN se usa en las siguientes solicitudes de conjunto de OID:

La estructura NDIS_SWITCH_PORT_PROPERTY_VLAN sigue la estructura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS del búfer asociado a estas solicitudes de conjunto de OID. El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a este búfer.

Las propiedades de puerto, como NDIS_SWITCH_PORT_PROPERTY_VLAN, se aplican mediante la extensión de conmutador extensible que se instala como una extensión de reenvío. Este tipo de extensión aplica sus propias reglas para reenviar paquetes, IDENTIFICADORes y indicaciones de estado a través de la pila extensible del controlador de conmutador. Solo puede haber una extensión de reenvío por cada instancia de un conmutador extensible.

Para obtener más información sobre las extensiones de reenvío, vea Reenvío de extensiones.

Nota Si no se instala una extensión de reenvío, la interfaz de conmutador extensible aplica la propia propiedad port.