estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS (ntddndis.h)

Artigo
02/26/2024

A estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS especifica uma matriz de propriedades de política para uma porta de comutador extensível do Hyper-V. Cada elemento na matriz é formatado como uma estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO .

Sintaxe

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
  USHORT                                   Reserved;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_PORT_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_PORT_PROPERTY_ENUM_PARAMETERS , o membro Revision do Header deve ser definido com o seguinte valor:

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_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 de comutador extensível para a qual as propriedades são enumeradas.

PropertyType

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

PropertyId

Um valor guid que identifica a propriedade para a porta de comutador extensível.

SerializationVersion

Um valor NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION que identifica a versão de formato dos dados da propriedade da porta serializada. 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_PORT_PROPERTY_ENUM_INFO que segue a estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS . O deslocamento é medido desde o início da estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS até o início do primeiro elemento da 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_PORT_PROPERTY_ENUM_INFO que seguem a estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS .

Reserved

Reservado para uso futuro.

Comentários

A estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS é usada em solicitações de método OID de OID_SWITCH_PORT_PROPERTY_ENUM. Uma matriz de estruturas de NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO segue a estrutura NDIS_SWITCH_PORT_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 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO especificada pela estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS usando a macro NDIS_SWITCH_PORT_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.