estructura NDIS_SWITCH_PARAMETERS (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_SWITCH_PARAMETERS contiene los datos de configuración de un conmutador extensible de 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 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_PARAMETERS , el miembro Revision de Header 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 de ULONG que contiene un OR bit a bit de marcas. Este miembro está reservado para NDIS.

SwitchName

Valor de 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 conmutador interno. Para obtener más información, consulte Administración de directivas de conmutador extensible de Hyper-V.

SwitchFriendlyName

Valor de 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

Un valor BOOLEAN que, si ES TRUE, indica que la activación del conmutador extensible de 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 NetEventSwitchActivate antes de consultar la configuración del conmutador.

Comentarios

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 los controladores de llamada de la Plataforma de filtrado de Windows:

Nota Los tipos de datos NDIS_SWITCH_NAME y NDIS_SWITCH_FRIENDLYNAME están definidos por el tipo definido por la estructura 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.