NDIS_SWITCH_NIC_SAVE_STATE Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SWITCH_NIC_SAVE_STATE-Struktur gibt die Laufzeitstatusinformationen für einen Hyper-V erweiterbaren Switchport an. Die erweiterbare Switcherweiterung verwendet diese Struktur, um Laufzeitportinformationen zu speichern oder wiederherzustellen.

Syntax

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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SWITCH_NIC_SAVE_STATE Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Das element TypeHeader muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_NIC_SAVE_STATE-Struktur anzugeben, muss das element RevisionHeader- auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Size Member auf NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises ODER von Flags enthält. Dieses Mitglied ist für NDIS reserviert.

PortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Switchports enthält.

NicIndex

Ein NDIS_SWITCH_NIC_INDEX Wert, der den Nic-Index für den Netzwerkadapter enthält. Dieser Wert ist immer 0. Weitere Informationen finden Sie unter Netzwerkadapterindexwerte.

ExtensionId

Ein GUID-Wert, der die erweiterbare Switcherweiterung identifiziert.

ExtensionFriendlyName

Ein NDIS_SWITCH_EXTENSION_FRIENDLYNAME Wert, der die benutzerfreundlichen Beschreibung der Erweiterbarkeitsoptionserweiterung angibt.

FeatureClassId

Ein GUID-Wert, der den Bezeichner der Featureklasse enthält, die sich auf die gespeicherten Daten bezieht. Ein Featureklassenbezeichner wird durch die Erweiterung definiert, um Komponenten seiner Laufzeitdaten eindeutig zu identifizieren.

Hinweis Dieses Mitglied ist optional. Die erweiterungsfähige Switcherweiterung muss dieses Element auf 0 festlegen, wenn die gespeicherten Daten keine Featureklasse besitzen.

SaveDataSize

Ein USHORT-Wert, der die Größe der Im SaveData Member enthaltenen Daten in Byte angegeben hat.

Hinweis Dieser Wert muss kleiner oder gleich NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE sein.

SaveDataOffset

Ein USHORT-Wert, der den Offset vom Anfang der Struktur bis zu den gespeicherten oder wiederhergestellten Laufzeitstatusinformationen enthält.

SaveDataSizeOverflow

Bemerkungen

Die NDIS_SWITCH_NIC_SAVE_STATE Struktur wird in den folgenden OID-Anforderungen verwendet:

Hinweis Der datentyp "NDIS_SWITCH_EXTENSION_FRIENDLYNAME" wird durch die IF_COUNTED_STRING-Struktur definiert. Eine durch diese Struktur definierte Zeichenfolge muss nicht null beendet werden. Die Länge der Zeichenfolge muss jedoch im Length Member dieser Struktur festgelegt werden. Wenn die Zeichenfolge null-beendet ist, darf das element Length nicht das endende Nullzeichen enthalten.

Weitere Informationen zum Speichern oder Wiederherstellen von Laufzeitportinformationen finden Sie unter Managing Hyper-V Extensible Switch Run-Time Data.