estructura NDIS_SWITCH_PARAMETERS (ntddndis.h)

Artículo
02/07/2025

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

Sintaxis

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_SWITCH_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_PARAMETERS, el miembro Revisión de Encabezado debe establecerse en el siguiente valor:

NDIS_SWITCH_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1.

Flags

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

SwitchName

Valor NDIS_SWITCH_NAME que especifica el nombre interno único del conmutador extensible.

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

SwitchFriendlyName

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

NumSwitchPorts

Valor UINT32 que especifica el número de puertos configurados en el conmutador extensible.

IsActive

BooleAN que si ES TRUE indica que la activación de conmutador extensible Hyper-V ha finalizado y es seguro consultar otras configuraciones de conmutador, como enumerar puertos, NIC y propiedades. Si es FALSE, la extensión debe esperar a que se emita el evento PNP de netEventSwitchActivate antes de consultar la configuración del conmutador.

Observaciones

La estructura NDIS_SWITCH_PARAMETERS se usa en la solicitud OID de OID_SWITCH_PARAMETERS.

Esta estructura también se pasa en el parámetro vSwitch de las siguientes funciones de llamada para controladores de llamada de plataforma de filtrado de Windows:

Nota Los tipos de datos NDIS_SWITCH_NAME y NDIS_SWITCH_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.