NDIS_SWITCH_NIC_SAVE_STATE 结构 (ntddndis.h)

项目
08/07/2023

NDIS_SWITCH_NIC_SAVE_STATE 结构指定 Hyper-V 可扩展交换机端口的运行时状态信息。可扩展交换机扩展使用此结构来保存或还原运行时端口信息。

语法

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;

成员

Header

NDIS_SWITCH_NIC_SAVE_STATE 结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

Header 的 Type 成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SWITCH_NIC_SAVE_STATE 结构的版本，必须将 Header 的 Revision 成员设置为以下值：

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

NDIS 6.30 及更高版本的原始版本。

将 Size 成员设置为NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1。

Flags

包含标志的按位 OR 的 ULONG 值。此成员是为 NDIS 保留的。

PortId

一个NDIS_SWITCH_PORT_ID值，该值包含可扩展交换机端口的唯一标识符。

NicIndex

包含网络适配器的 Nic 索引的 NDIS_SWITCH_NIC_INDEX 值。此值始终为 0。有关详细信息，请参阅网络适配器索引值。

ExtensionId

标识可扩展交换机扩展的 GUID 值。

ExtensionFriendlyName

一个 NDIS_SWITCH_EXTENSION_FRIENDLYNAME 值，该值指定可扩展开关扩展的用户友好说明。

FeatureClassId

一个 GUID 值，该值包含与保存的数据相关的特征类的标识符。特征类标识符由扩展定义，用于唯一标识其运行时数据的组件。

注意此成员是可选的。如果保存的数据没有特征类，则可扩展开关扩展必须将此成员设置为 0。

SaveDataSize

一个 USHORT 值，该值指定 SaveData 成员中包含的数据的大小（以字节为单位）。

注意此值必须小于或等于 NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE。

SaveDataOffset

一个 USHORT 值，该值包含从结构开头到要保存或还原的运行时状态信息的偏移量。

SaveDataSizeOverflow

注解

NDIS_SWITCH_NIC_SAVE_STATE 结构用于以下 OID 请求：

注意 NDIS_SWITCH_EXTENSION_FRIENDLYNAME数据类型由 IF_COUNTED_STRING 结构定义。此结构定义的字符串不必以 null 结尾。但是，字符串的长度必须在此结构的 Length 成员中设置。如果字符串以 null 结尾，则 Length 成员不得包含终止 null 字符。

有关如何保存或还原运行时端口信息的详细信息，请参阅管理 Hyper-V 可扩展交换机 Run-Time 数据。