estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS (ntddndis.h)

Artigo
02/26/2024

A estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS especifica uma matriz de propriedades de perfil para o comutador extensível do 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 Type de Header deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS , o membro Revision do Header deve ser definido com o seguinte valor:

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

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

PropertyType

Um NDIS_SWITCH_PROPERTY_TYPE valor de enumeração 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 de propriedade do comutador extensível serializado. Esses dados são serializados para acesso pela extensão do arquivo MOF (Managed Object Format) que definiu a propriedade .

Nota Para 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.

Nota 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 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS .

Comentários

A estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS é usada em solicitações de método OID de OID_SWITCH_PROPERTY_ENUM. Uma matriz de estruturas 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 membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer de informações.

As extensões de comutador extensíveis 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íveis, consulte Políticas de comutador extensível do Hyper-V.