estructura NDIS_SWITCH_PORT_PARAMETERS (ntddndis.h)

Artículo
02/07/2025

La estructura NDIS_SWITCH_PORT_PARAMETERS contiene los datos de configuración de un puerto de conmutador extensible Hyper-V.

Sintaxis

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

Miembros

Header

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

El miembro Type de Encabezado debe establecerse en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_SWITCH_PORT_PARAMETERS, el miembro revisión de de encabezado debe establecerse en el siguiente valor:

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro tamaño de en NDIS_SIZEOF_NDIS_SWITCH_PORT_PARAMETERS_REVISION_1.

Flags

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

PortId

Valor NDIS_SWITCH_PORT_ID que contiene el identificador único del puerto de conmutador extensible.

PortName

Valor NDIS_SWITCH_PORT_NAME que especifica el nombre interno único del puerto de conmutador extensible.

Las aplicaciones de administración de directivas basadas en WMI usan el nombre de puerto interno. Para obtener más información, vea Administración de directivas de conmutador extensible de Hyper-V.

PortFriendlyName

Valor de NDIS_SWITCH_PORT_FRIENDLYNAME que especifica la descripción fácil de usar del puerto de conmutador extensible.

PortType

Valor NDIS_SWITCH_PORT_TYPE que especifica el tipo del puerto de conmutador extensible.

IsValidationPort

Si es TRUE, indica un puerto que se crea temporalmente con fines de prueba y validación antes de establecer una conexión de adaptador de red de máquina virtual. Para obtener más información sobre este tipo de puerto, consulte puertos de validación.

PortState

Valor NDIS_SWITCH_PORT_STATE que especifica el estado actual del puerto.

Observaciones

El miembro InformationBuffer de la estructura de NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_SWITCH_PORT_PARAMETERS para las siguientes solicitudes OID:

Las solicitudes de consulta OID de OID_SWITCH_PORT_ARRAY devuelven una estructura NDIS_SWITCH_PORT_ARRAY que contiene una matriz de elementos. Cada elemento tiene el formato de estructura NDIS_SWITCH_PORT_PARAMETERS.

Las extensiones de conmutador extensible pueden acceder al búfer de propiedades de puerto dentro de una estructura de NDIS_SWITCH_PORT_PARAMETERS mediante la macro NDIS_SWITCH_PORT_AT_ARRAY_INDEX.

Nota Los tipos de datos NDIS_SWITCH_PORT_NAME y NDIS_SWITCH_PORT_FRIENDLYNAME están definidos por la estructura de IF_COUNTED_STRING. Una cadena definida por esta estructura no tiene que terminar en null. Sin embargo, la longitud de la cadena debe establecerse en el miembro Length de esta estructura. Si la cadena termina en null, el miembro Length no debe incluir el carácter nulo de terminación.