NDIS_SWITCH_NIC_SAVE_STATE結構 (ntddndis.h)

發行項
02/26/2024

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結構的版本，標頭的 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

NDIS_SWITCH_NIC_INDEX值，其中包含網路適配器的 Nic 索引。此值一律為 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 數據。