структура NDIS_SWITCH_NIC_SAVE_STATE (ntddndis.h)

  • Статья

Структура 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заголовка следующее значение:

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

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

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

Flags

Значение ULONG, содержащее побитовое ИЛИ флагов. Этот элемент зарезервирован для 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 data.

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.30 и более поздних версиях.
Верхняя часть ntddndis.h (включая Ndis.h, Fwpsk.h)

См. также раздел

IF_COUNTED_STRING

NDIS_OBJECT_HEADER

OID_SWITCH_NIC_RESTORE

OID_SWITCH_NIC_SAVE

OID_SWITCH_NIC_SAVE_COMPLETE