estrutura NDIS_NIC_SWITCH_VF_PARAMETERS (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 miniporte deve definir o membro Tipo de Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_NIC_SWITCH_VF_PARAMETERS , o driver deve definir o membro Revision de Header como o seguinte valor:
NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1
Versão original do NDIS 6.30 e posterior.
Defina o membro Size como NDIS_SIZEOF_NIC_SWITCH_VF_PARAMETERS_REVISION_1.
Flags
Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse membro é reservado para o NDIS.
SwitchId
Um valor NDIS_NIC_SWITCH_ID que especifica um identificador de comutador. Esse valor identifica a opção do adaptador de rede na qual o VF está alocado.
O identificador de comutador é um número 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.
VMName
Um valor NDIS_VM_NAME que especifica o nome interno da partição filho do Hyper-V anexada ao VF.
VMFriendlyName
Um valor NDIS_VM_FRIENDLYNAME que especifica o nome externo da partição filho do Hyper-V anexada ao VF. Esse 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 do 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 Caminho de dados VF SR-IOV.
MacAddressLength
Um valor USHORT que especifica o comprimento dos membros PermanentMacAddress e CurrentMacAddress .
PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]
O endereço MAC permanente do VF. Esse é o endereço MAC permanente para o 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 para o 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.
Comentários
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 SR-IOV (Virtualização de E/S raiz única).
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.30 e posterior. |
| Cabeçalho | ntddndis.h (inclua Ndis.h) |
Confira também