estrutura NDIS_SWITCH_PORT_PROPERTY_PROFILE (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_SWITCH_PORT_PROPERTY_PROFILE especifica uma propriedade de política para uma porta de comutador extensível do Hyper-V que a extensão de comutador extensível salva em seu próprio repositório de políticas em vez de no repositório de políticas do Hyper-V. Nesse caso, as definições de política são identificadas por perfis de propriedade no repositório de políticas do driver.

Sintaxe

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PROFILE {
  NDIS_OBJECT_HEADER                          Header;
  ULONG                                       Flags;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME      ProfileName;
  GUID                                        ProfileId;
  NDIS_VENDOR_NAME                            VendorName;
  GUID                                        VendorId;
  UINT32                                      ProfileData;
  GUID                                        NetCfgInstanceId;
  struct {
    UINT32 PciSegmentNumber : 16;
    UINT32 PciBusNumber : 8;
    UINT32 PciDeviceNumber : 5;
    UINT32 PciFunctionNumber : 3;
  } PciLocation;
  UINT32                                      CdnLabelId;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL CdnLabel;
} NDIS_SWITCH_PORT_PROPERTY_PROFILE, *PNDIS_SWITCH_PORT_PROPERTY_PROFILE;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_PORT_PROPERTY_PROFILE . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O membro Tipo de Cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_PORT_PROPERTY_PROFILE , o membro Revision de Header deve ser definido como o seguinte valor:

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1.

Flags

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

ProfileName

Um valor NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME que especifica o nome amigável da propriedade de perfil.

ProfileId

Um valor GUID que identifica exclusivamente a propriedade de perfil.

VendorName

Um valor NDIS_VENDOR_NAME que especifica o nome amigável do fornecedor que definiu o perfil de porta.

VendorId

Um valor GUID que identifica o fornecedor que definiu o perfil de porta.

ProfileData

NetCfgInstanceId

Um valor GUID que especifica o valor do registro NetCfgInstanceId da conexão do adaptador de rede subjacente para a qual a propriedade é aplicada.

O valor NetCfgInstanceId é especificado para a conexão do adaptador de rede por meio de uma solicitação de conjunto OID (identificador de objeto) de OID_SWITCH_NIC_CREATE.

PciLocation

Uma estrutura que especifica o local PCI do adaptador de rede físico subjacente especificado pelo membro NetCfgInstanceId .

Para obter mais informações, consulte a seção Comentários.

PciLocation.PciSegmentNumber

Um valor que especifica o grupo de barramentos PCI nos quais o adaptador de rede física está anexado.

PciLocation.PciBusNumber

Um valor que especifica o número atual do barramento PCI no qual o adaptador de rede física está anexado.

PciLocation.PciDeviceNumber

Um valor que especifica o número do dispositivo para o adaptador de rede física no barramento PCI.

Nota O número do dispositivo PCI também é conhecido como o número do slot PCI.

PciLocation.PciFunctionNumber

Um valor que especifica o número de função de um dispositivo lógico no adaptador de rede física.

CdnLabelId

Um valor UINT32 que especifica um identificador exclusivo para os dados contidos no membro CdnLabel .

CdnLabel

Um valor NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL que especifica o rótulo CDN do PCI Express (PCIe) para o local do adaptador de rede física. Um rótulo cdn fornece locais de dispositivo consistentes em locais de hardware semelhantes.

Comentários

A estrutura NDIS_SWITCH_PORT_PROPERTY_PROFILE é usada pela extensão para fazer referência a uma propriedade de política dentro de um repositório de políticas privadas em vez do repositório de políticas do Hyper-V. Isso permite que o ISV (fornecedor independente de software) preencha e gerencie esse repositório de políticas privadas por meio de canais e interfaces privadas. Os fornecedores podem distinguir seus perfis dos perfis de outros fornecedores usando os campos VendorName e VendorId .

Nota As propriedades de política de porta especificadas por uma estrutura de NDIS_SWITCH_PORT_PROPERTY_PROFILE são transparentes para a interface de comutador extensível.

A estrutura NDIS_SWITCH_PORT_PROPERTY_PROFILE é usada nas seguintes solicitações de conjunto de OID:

A estrutura NDIS_SWITCH_PORT_PROPERTY_PROFILE segue a estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS no buffer associado a essas solicitações de conjunto de OID. O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer.

Nota Os tipos de dados NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME e NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL são definidos pelo tipo pela estrutura IF_COUNTED_STRING . Uma cadeia de caracteres definida por essa estrutura não precisa ser terminada em nulo. No entanto, o comprimento da cadeia de caracteres deve ser definido no membro Length dessa estrutura. Se a cadeia de caracteres for terminada em nulo, o membro Length não deverá incluir o caractere nulo de terminação.

Os membros PciLocation e CdnLabel só serão relevantes se o perfil de propriedade especificar uma política para um adaptador de rede físico subjacente anexado ao adaptador de rede externo comutador extensível. Por exemplo, se o adaptador de rede externo estiver associado a uma equipe de adaptadores de comutador extensível, esses membros poderão especificar políticas para um único adaptador dessa equipe. Para obter mais informações sobre a equipe de comutador extensível, consulte Tipos de Configurações do Adaptador de Rede Física.