estructura NDIS_SWITCH_PORT_PARAMETERS (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_SWITCH_PORT_PARAMETERS contiene los datos de configuración de un puerto de conmutador extensible de 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 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_PARAMETERS , el miembro Revision de Header 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 Size en NDIS_SIZEOF_NDIS_SWITCH_PORT_PARAMETERS_REVISION_1.

Flags

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

PortId

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

PortName

Valor de 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, consulte 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 de NDIS_SWITCH_PORT_TYPE que especifica el tipo del puerto de conmutador extensible.

IsValidationPort

Si es TRUE, indica un puerto que se crea temporalmente para 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, vea Puertos de validación.

PortState

Valor NDIS_SWITCH_PORT_STATE que especifica el estado actual del puerto.

Comentarios

El miembro InformationBuffer de la estructura 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 formato de estructura NDIS_SWITCH_PORT_PARAMETERS .

Las extensiones de conmutador extensible pueden acceder al búfer de propiedades del 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 se definen mediante 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.