estructura NDIS_SWITCH_PORT_PROPERTY_SECURITY (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_SWITCH_PORT_PROPERTY_SECURITY especifica una propiedad de directiva de seguridad para un puerto de conmutador extensible de Hyper-V.

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_SWITCH_PORT_PROPERTY_SECURITY . 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 NDIS_SWITCH_PORT_PROPERTY_SECURITY , el miembro Revision de Header debe establecerse en el siguiente valor:

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1.

Flags

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

AllowMacSpoofing

Valor BOOLEAN que, si se establece en TRUE, especifica que el puerto puede enviar paquetes con una dirección de control de acceso a medios de origen (MAC) diferente de su dirección MAC permanente. La dirección MAC permanente del puerto se configura a través de una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_CREATE.

AllowIeeePriorityTag

Valor BOOLEAN que, si se establece en TRUE, especifica que el puerto debe conservar la información de prioridad 802.1Q en la estructura NET_BUFFER_LIST de un paquete cuando el paquete se reenvía al puerto. El puerto debe conservar la información de prioridad solo si el miembro PreservePriority está establecido en la unión NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO de los datos fuera de banda de la estructura NET_BUFFER_LIST del paquete.

VirtualSubnetId

Valor UINT32 que especifica la virtualización de red VirtualSubnetId que está configurada en el puerto. Si la virtualización de red no está configurada en el puerto, el valor será 0. Los datos de NET_BUFFER_LIST NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO fuera de banda contienen virtualSubnetId, que se rellena con la pertenencia a la subred virtual del tráfico.

AllowTeaming

Valor BOOLEAN que, si se establece en TRUE, especifica que se permite la conmutación por error de formación de equipos para el puerto, de modo que el puerto pueda enviar paquetes con una dirección de control de acceso a medios de origen (MAC) diferente de su PermanentMacAddress, pero igual a la dirección MAC que está actualmente en uso por otro puerto conectado a la misma máquina virtual. La dirección MAC permanente del puerto se configura a través de una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_CREATE OID_SWITCH_NIC_UPDATE/.

DynamicIPAddressLimit

Valor UINT32 que especifica el número máximo de direcciones IP dinámicas que se pueden aprender para el puerto.

Comentarios

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

La estructura de NDIS_SWITCH_PORT_PROPERTY_SECURITY sigue la estructura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS en el 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_SECURITY, 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.