NDIS_SWITCH_NIC_SAVE_STATE estrutura (ntddndis.h)

Artigo
02/07/2025

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 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 tipo do de cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_SWITCH_NIC_SAVE_STATE, o membro de Revisão do de Cabeçalho deve ser definido como o seguinte valor:

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1.

Flags

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

PortId

Um valor NDIS_SWITCH_PORT_ID que contém o identificador exclusivo da porta de 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.

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

SaveDataSize

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

Observação 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

Observações

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

Observação O tipo de dados NDIS_SWITCH_EXTENSION_FRIENDLYNAME é definido por 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 comprimento dessa estrutura. Se a cadeia de caracteres for terminada em nulo, o membro Length não deverá incluir o caractere nulo de encerramento.

Para obter mais informações sobre como salvar ou restaurar informações de porta em tempo de execução, consulte Gerenciando Hyper-Vde dados de comutador extensível Run-Time .