NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS especifica uma matriz de propriedades de perfil para o comutador extensível Hyper-V. Cada elemento na matriz é formatado como uma estrutura NDIS_SWITCH_PROPERTY_ENUM_INFO.

Sintaxe

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
} NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PROPERTY_ENUM_PARAMETERS;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS. 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_PROPERTY_ENUM_PARAMETERS, o membro de Revisão do de Cabeçalho deve ser definido como o seguinte valor:

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

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

PropertyType

Um valor de enumeração NDIS_SWITCH_PROPERTY_TYPE que especifica o tipo de propriedade de comutador extensível. Quando uma solicitação de método OID de OID_SWITCH_PROPERTY_ENUM é emitida, a extensão de comutador extensível retorna propriedades de comutador extensíveis que correspondem a esse tipo de propriedade.

PropertyId

Um valor GUID que identifica a propriedade de comutador extensível.

SerializationVersion

Um valor NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION que identifica a versão de formato dos dados da propriedade de comutador extensível serializado. Esses dados são serializados para acesso pela extensão do arquivo MOF (Managed Object Format) que definiu a propriedade.

Observação para o Windows Server 2012, o membro serializationVersion deve ser definido como NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

FirstPropertyOffset

Um valor USHORT que especifica o deslocamento, em bytes, para o primeiro elemento NDIS_SWITCH_PROPERTY_ENUM_INFO que segue a estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS. O deslocamento é medido desde o início da estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS até o início do primeiro elemento na matriz.

Observação Se o valor de NumProperties for zero, esse membro será ignorado.

NumProperties

Um valor ULONG que especifica o número de elementos NDIS_SWITCH_PROPERTY_ENUM_INFO que seguem a estrutura de NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS.

Observações

A estrutura de NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS é usada em solicitações de método OID de OID_SWITCH_PROPERTY_ENUM. Uma matriz de estruturas de NDIS_SWITCH_PROPERTY_ENUM_INFO segue a estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS no buffer de informações associado a essas solicitações de conjunto de OID. O informationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer de informações.

As extensões de comutador extensível podem acessar a primeira estrutura de NDIS_SWITCH_PROPERTY_ENUM_INFO especificada pela estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS usando a macro NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO.

Para obter mais informações sobre políticas de comutador extensível, consulte Hyper-V Políticas de Comutador Extensível.