estrutura NDIS_SWITCH_PROPERTY_ENUM_INFO (ntddndis.h)

Artigo
02/26/2024

A estrutura NDIS_SWITCH_PROPERTY_ENUM_INFO especifica informações sobre uma propriedade de perfil para o comutador extensível do Hyper-V.

Sintaxe

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PROPERTY_ENUM_INFO;

Membros

Header

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

NDIS_SWITCH_PROPERTY_ENUM_INFO_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.

PropertyInstanceId

Um valor NDIS_SWITCH_OBJECT_INSTANCE_ID que especifica o identificador de instância da propriedade de comutador extensível.

PropertyVersion

Um valor NDIS_SWITCH_OBJECT_VERSION que identifica a versão da propriedade para a porta de comutador extensível.

QwordAlignedPropertyBufferLength

Um valor ULONG que especifica o tamanho alinhado, em bytes, do buffer de propriedade.

PropertyBufferLength

Um valor ULONG que especifica o tamanho real, em bytes, do buffer de propriedade.

Nota Esse valor deve ser menor ou igual ao valor do membro QwordAlignedPropertyBufferLength .

PropertyBufferOffset

Um valor ULONG que especifica o deslocamento, em bytes, para o buffer de propriedades que segue a estrutura NDIS_SWITCH_PROPERTY_ENUM_INFO . O deslocamento é medido desde o início da estrutura NDIS_SWITCH_PROPERTY_PARAMETERS até o início do buffer de propriedades.

Comentários

A estrutura NDIS_SWITCH_PROPERTY_ENUM_INFO é usada em solicitações de conjunto de 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 o próximo elemento NDIS_SWITCH_PROPERTY_ENUM_INFO que segue uma estrutura NDIS_SWITCH_PROPERTY_ENUM_INFO na matriz usando a macro NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_NEXT .

As extensões de comutador extensíveis podem acessar o buffer de propriedade do comutador extensível especificado por uma estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO usando a macro NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_PROPERTY .

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