структура 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.

Элемент типазаголовка должен иметь значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_SWITCH_NIC_SAVE_STATE, редакции члена заголовка необходимо задать следующее значение:

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

Исходная версия для NDIS 6.30 и более поздних версий.

Задайте для элемента размер NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1.

Flags

Значение ULONG, содержащее побитовое OR флагов. Этот элемент зарезервирован для NDIS.

PortId

Значение NDIS_SWITCH_PORT_ID, содержащее уникальный идентификатор расширяемого порта коммутатора.

NicIndex

Значение 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 данных.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.30 и более поздних версиях.
заголовка	ntddndis.h (include Ndis.h, Fwpsk.h)

См. также

IF_COUNTED_STRING

NDIS_OBJECT_HEADER

OID_SWITCH_NIC_RESTORE

OID_SWITCH_NIC_SAVE

OID_SWITCH_NIC_SAVE_COMPLETE

Поделиться через