estructura NDIS_SWITCH_NIC_SAVE_STATE (ntddndis.h)

Artículo
02/07/2025

La estructura NDIS_SWITCH_NIC_SAVE_STATE especifica la información de estado en tiempo de ejecución de un puerto de conmutador extensible Hyper-V. La extensión de conmutador extensible usa esta estructura para guardar o restaurar la información del puerto en tiempo de ejecución.

Sintaxis

typedef struct _NDIS_SWITCH_NIC_SAVE_STATE {
  NDIS_OBJECT_HEADER                 Header;
  ULONG                              Flags;
  NDIS_SWITCH_PORT_ID                PortId;
  NDIS_SWITCH_NIC_INDEX              NicIndex;
  GUID                               ExtensionId;
  NDIS_SWITCH_EXTENSION_FRIENDLYNAME ExtensionFriendlyName;
  GUID                               FeatureClassId;
  USHORT                             SaveDataSize;
  USHORT                             SaveDataOffset;
  ULONG                              SaveDataSizeOverflow;
} NDIS_SWITCH_NIC_SAVE_STATE, *PNDIS_SWITCH_NIC_SAVE_STATE;

Miembros

Header

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

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro tamaño de en NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_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.

NicIndex

Valor NDIS_SWITCH_NIC_INDEX que contiene el índice de Nic para el adaptador de red. Este valor siempre será 0. Para obtener más información, consulte valores de índice del adaptador de red.

ExtensionId

Valor GUID que identifica la extensión de conmutador extensible.

ExtensionFriendlyName

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

FeatureClassId

Valor GUID que contiene el identificador de la clase de característica relacionada con los datos guardados. La extensión define un identificador de clase de característica para identificar de forma única los componentes de sus datos en tiempo de ejecución.

Nota Este miembro es opcional. La extensión de conmutador extensible debe establecer este miembro en 0 si los datos guardados no tienen ninguna clase de característica.

SaveDataSize

Valor de USHORT que especificó el tamaño, en bytes, de los datos contenidos en el miembro SaveData.

Nota Este valor debe ser menor o igual que NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE.

SaveDataOffset

Valor de USHORT que contiene el desplazamiento desde el principio de la estructura hasta la información de estado en tiempo de ejecución que se guarda o restaura.

SaveDataSizeOverflow

Observaciones

La estructura NDIS_SWITCH_NIC_SAVE_STATE se usa en las siguientes solicitudes de OID:

Nota El tipo de datos NDIS_SWITCH_EXTENSION_FRIENDLYNAME está definido 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.

Para obtener más información sobre cómo guardar o restaurar información sobre el puerto en tiempo de ejecución, consulte Administración de Hyper-V conmutador extensible Run-Time Data.