estructura NDIS_SWITCH_NIC_SAVE_STATE (ntddndis.h)

Artículo
03/08/2023

La estructura de NDIS_SWITCH_NIC_SAVE_STATE especifica la información de estado en tiempo de ejecución de un puerto de conmutador extensible de 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 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_NIC_SAVE_STATE , el miembro Revision de Header 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 Size en NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_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.

NicIndex

Valor NDIS_SWITCH_NIC_INDEX que contiene el índice Nic para el adaptador de red. Este valor siempre será 0. Para obtener más información, vea 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 de conmutador extensible.

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 inicio de la estructura hasta la información de estado en tiempo de ejecución que se va a guardar o restaurar.

SaveDataSizeOverflow

Comentarios

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 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.

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