Compartilhar via


NDIS_NIC_SWITCH_VF_PARAMETERS estrutura (ntddndis.h)

O NDIS_NIC_SWITCH_VF_PARAMETERS especifica os parâmetros de recurso de uma VF (Função Virtual) PCI Express (PCIe) em um adaptador de rede.

Sintaxe

typedef struct _NDIS_NIC_SWITCH_VF_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_VM_NAME           VMName;
  NDIS_VM_FRIENDLYNAME   VMFriendlyName;
  NDIS_SWITCH_NIC_NAME   NicName;
  USHORT                 MacAddressLength;
  UCHAR                  PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                  CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_SRIOV_FUNCTION_ID VFId;
  NDIS_VF_RID            RequestorId;
} NDIS_NIC_SWITCH_VF_PARAMETERS, *PNDIS_NIC_SWITCH_VF_PARAMETERS;

Membros

Header

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

O driver de miniporto deve definir o membro tipo do de cabeçalho para NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_NIC_SWITCH_VF_PARAMETERS, o driver deve definir o membro de Revisão do de Cabeçalho para o seguinte valor:

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho do como NDIS_SIZEOF_NIC_SWITCH_VF_PARAMETERS_REVISION_1.

Flags

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

SwitchId

Um valor NDIS_NIC_SWITCH_ID que especifica um identificador de comutador. Esse valor identifica o comutador do adaptador de rede no qual o VF é alocado.

O identificador de comutador é um inteiro entre zero e o número de comutadores compatíveis com o adaptador de rede. Um valor NDIS_DEFAULT_SWITCH_ID indica o comutador de adaptador de rede padrão.

Observação Começando com o Windows Server 2012, a interface de virtualização de E/S raiz única (SR-IOV) só dá suporte ao comutador de adaptador de rede padrão no adaptador de rede. O valor desse membro deve ser definido como NDIS_DEFAULT_SWITCH_ID.
 

VMName

Um valor NDIS_VM_NAME que especifica o nome interno da partição filho Hyper-V anexada ao VF.

Observação A partição filho Hyper-V também é conhecida como uma VM (máquina virtual).
 

VMFriendlyName

Um valor NDIS_VM_FRIENDLYNAME que especifica o nome externo da partição filho Hyper-V anexada ao VF. Este membro contém a descrição amigável da partição.

NicName

Um valor NDIS_SWITCH_NIC_NAME que especifica o nome do adaptador de rede da VM (máquina virtual). Esse membro contém a descrição amigável do adaptador de rede.

O adaptador de rede da VM é um dispositivo virtual exposto no sistema operacional convidado que é executado em uma partição filho Hyper-V. As equipes do adaptador de rede da VM com o adaptador de rede VF para fornecer o caminho de dados VF baseado em hardware pela interface SR-IOV.

Para obter mais informações sobre o caminho de dados do VF, consulte SR-IOVde caminho de dados VF.

MacAddressLength

Um valor USHORT que especifica o comprimento dos membros PermanentMacAddress e CurrentMacAddress.

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

O endereço MAC permanente da VF. Esse é o endereço MAC permanente do adaptador de rede VF exposto no sistema operacional convidado.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

O endereço MAC atual do VF. Esse é o endereço MAC atual do adaptador de rede VF exposto no sistema operacional convidado.

VFId

Um valor NDIS_SRIOV_FUNCTION_ID que especifica o identificador exclusivo do VF no adaptador de rede.

RequestorId

Um NDIS_VF_RID que especifica a ID do solicitante PCI Express (PCIe) (RID) do VF.

Observações

A estrutura de NDIS_NIC_SWITCH_VF_PARAMETERS é usada em solicitações de método OID de OID_NIC_SWITCH_ALLOCATE_VF e OID_NIC_SWITCH_VF_PARAMETERS.

Para obter mais informações sobre a interface SR-IOV, consulte Visão geral da virtualização de E/S de Raiz Única (SR-IOV).

Requisitos

Requisito Valor
de cliente com suporte mínimo Com suporte no NDIS 6.30 e posterior.
cabeçalho ntddndis.h (inclua Ndis.h)

Consulte também

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_VF_PARAMETERS