NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO contém informações sobre uma propriedade de política de porta de comutador extensível Hyper-V.

Sintaxe

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_INFO;

Membros

Header

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

NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro do 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. Este membro é reservado para NDIS.

PropertyVersion

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

PropertyInstanceId

Um valor NDIS_SWITCH_OBJECT_INSTANCE_ID que especifica o identificador de instância para a propriedade de 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.

Observação 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 propriedade que segue a estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO. O deslocamento é medido desde o início da estrutura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS até o início do buffer de propriedade.

Observações

A estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO é 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 de NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS no buffer de informações associado a essa solicitação 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 o próximo elemento NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO que segue uma estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO na matriz usando a macro NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO_GET_NEXT.

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

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