NDIS_SWITCH_NIC_SAVE_STATE Struktur (ntddndis.h)

Artikel
08/07/2023

Die NDIS_SWITCH_NIC_SAVE_STATE-Struktur gibt die Laufzeitstatusinformationen für einen erweiterbaren Hyper-V-Switchport an. Die erweiterbare Switch-Erweiterung verwendet diese Struktur zum Speichern oder Wiederherstellen von Laufzeitportinformationen.

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;

Member

Header

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

Das Type-Element von Header muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_NIC_SAVE_STATE-Struktur anzugeben, muss das Revisionselement von Header auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

Ursprüngliche Version für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Dieses Element 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 Indexwerte des Netzwerkadapters.

ExtensionId

Ein GUID-Wert, der die erweiterbare Switcherweiterung identifiziert.

ExtensionFriendlyName

Ein NDIS_SWITCH_EXTENSION_FRIENDLYNAME Wert, der die benutzerfreundliche Beschreibung der erweiterbaren Switcherweiterung 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 der Laufzeitdaten eindeutig zu identifizieren.

Hinweis Dieses Element ist optional. Die erweiterbare Switcherweiterung muss diesen Member auf 0 festlegen, wenn die gespeicherten Daten über keine Featureklasse verfügen.

SaveDataSize

Ein USHORT-Wert, der die Größe der Im SaveData-Member enthaltenen Daten in Bytes angibt.

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 zu speichernden oder wiederhergestellten Laufzeitzustandsinformationen enthält.

SaveDataSizeOverflow

Hinweise

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

Hinweis Der NDIS_SWITCH_EXTENSION_FRIENDLYNAME Datentyp wird von der IF_COUNTED_STRING-Struktur definiert. Eine Zeichenfolge, die von dieser Struktur definiert wird, muss nicht NULL-endend sein. Die Länge der Zeichenfolge muss jedoch im Length-Element dieser Struktur festgelegt werden. Wenn die Zeichenfolge null-beendet ist, darf das Length-Element das beendende NULL-Zeichen nicht enthalten.

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