NDIS_SWITCH_NIC_SAVE_STATE結構（ntddndis.h）

發行項
02/07/2025

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 結構。

標頭的 Type 成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SWITCH_NIC_SAVE_STATE 結構的版本，Revision member of Header 必須設定為下列值：

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

NDIS 6.30 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1。

Flags

ULONG 值，其中包含旗標的位 OR。此成員保留給 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 成員中包含的數據大小，以位元組為單位。

Note 此值必須小於或等於 NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE。

SaveDataOffset

USHORT 值，其中包含結構開頭到儲存或還原的運行時間狀態資訊位移。

SaveDataSizeOverflow

言論

NDIS_SWITCH_NIC_SAVE_STATE 結構用於下列 OID 要求：

Note NDIS_SWITCH_EXTENSION_FRIENDLYNAME 資料類型是由 IF_COUNTED_STRING 結構所定義。這個結構所定義的字串不必以 Null 結尾。不過，字串的長度必須在這個結構的 Length 成員中設定。如果字串為 null 終止，則 Length 成員不得包含終止的 Null 字元。

如需如何儲存或還原執行時間埠資訊的詳細資訊，請參閱管理 Hyper-V 可延伸交換器 Run-Time 資料。