estrutura NDIS_SWITCH_NIC_SAVE_STATE (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_SWITCH_NIC_SAVE_STATE especifica as informações de estado de tempo de execução para uma porta de comutador extensível do Hyper-V. A extensão de comutador extensível usa essa estrutura para salvar ou restaurar informações de porta em tempo de execução.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_NIC_SAVE_STATE . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O membro Type de Header deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_NIC_SAVE_STATE , o membro Revision de Header deve ser definido com o seguinte valor:

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse membro é reservado para NDIS.

PortId

Um valor NDIS_SWITCH_PORT_ID que contém o identificador exclusivo da porta do comutador extensível.

NicIndex

Um valor NDIS_SWITCH_NIC_INDEX que contém o Índice nic para o adaptador de rede. Esse valor sempre será 0. Para obter mais informações, consulte Valores de índice do adaptador de rede.

ExtensionId

Um valor guid que identifica a extensão de comutador extensível.

ExtensionFriendlyName

Um valor NDIS_SWITCH_EXTENSION_FRIENDLYNAME que especifica a descrição amigável da extensão de comutador extensível.

FeatureClassId

Um valor GUID que contém o identificador da classe de recurso relacionada aos dados salvos. Um identificador de classe de recurso é definido pela extensão para identificar exclusivamente os componentes de seus dados em tempo de execução.

Nota Esse membro é opcional. A extensão de comutador extensível deve definir esse membro como 0 se os dados salvos não tiverem nenhuma classe de recurso.

SaveDataSize

Um valor USHORT que especificou o tamanho, em bytes, dos dados contidos no membro SaveData .

Nota Esse valor deve ser menor ou igual a NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE.

SaveDataOffset

Um valor USHORT que contém o deslocamento do início da estrutura para as informações de estado em tempo de execução que estão sendo salvas ou restauradas.

SaveDataSizeOverflow

Comentários

A estrutura NDIS_SWITCH_NIC_SAVE_STATE é usada nas seguintes solicitações OID:

Nota O tipo de dados NDIS_SWITCH_EXTENSION_FRIENDLYNAME é definido pelo tipo pela estrutura IF_COUNTED_STRING . Uma cadeia de caracteres definida por essa estrutura não precisa ser terminada em nulo. No entanto, o comprimento da cadeia de caracteres deve ser definido no membro Length dessa estrutura. Se a cadeia de caracteres for terminada em nulo, o membro Length não deverá incluir o caractere nulo de terminação.

Para obter mais informações sobre como salvar ou restaurar informações de porta em tempo de execução, consulte Managing Hyper-V Extensible Switch Run-Time Data.