NDIS_NIC_SWITCH_VPORT_PARAMETERS estrutura (ntddndis.h)
A estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS especifica a configuração de uma porta virtual (VPort) em um comutador de adaptador de rede do adaptador de rede.
Sintaxe
typedef struct _NDIS_NIC_SWITCH_VPORT_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
NDIS_NIC_SWITCH_ID SwitchId;
NDIS_NIC_SWITCH_VPORT_ID VPortId;
NDIS_VPORT_NAME VPortName;
NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
ULONG NumQueuePairs;
NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
NDIS_NIC_SWITCH_VPORT_STATE VPortState;
GROUP_AFFINITY ProcessorAffinity;
ULONG LookaheadSize;
NDIS_NDK_PARAMETERS NdkParams;
NDIS_QOS_SQ_ID QosSqId;
} NDIS_NIC_SWITCH_VPORT_PARAMETERS, *PNDIS_NIC_SWITCH_VPORT_PARAMETERS;
Membros
Header
O tipo, a revisão e o tamanho da estrutura NDIS_NIC_SWITCH_VPORT_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 indicar a versão da estrutura de NDIS_NIC_SWITCH_VPORT_PARAMETERS, defina o membro de Revisão do de Cabeçalho como um dos seguintes valores:
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2
Adicionado o campo QosSqId para NDIS 6.50.
Defina o membro tamanho como NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2.
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1
Versão original do NDIS 6.30 e posterior.
Defina o membro tamanho como NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1.
Flags
Um valor ULONG que contém um OR bit a bit de sinalizadores. Os sinalizadores a seguir são definidos para este membro.
NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED
Esse sinalizador é reservado para uso futuro. Os drivers de miniporto devem ignorar esse sinalizador.
NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED
Esse sinalizador especifica que o membro Flags foi atualizado após a criação do VPort. Esses sinalizadores podem ser habilitados ou desabilitados após a criação do VPort usando uma solicitação de conjunto OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Esse sinalizador só é válido quando essa estrutura é usada em solicitações de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED
Esse sinalizador especifica que o membro VPortName foi atualizado após a criação do VPort. Esse membro pode ser atualizado usando uma solicitação de conjunto OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Esse sinalizador só é válido quando essa estrutura é usada em solicitações de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED
Esse sinalizador especifica que o membro InterruptModeration foi atualizado após a criação do VPort. Esse membro pode ser atualizado usando uma solicitação de conjunto OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Esse sinalizador só é válido quando essa estrutura é usada em solicitações de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED
Esse sinalizador especifica que o membro VPortState foi atualizado após a criação do VPort. Esse membro pode ser atualizado usando uma solicitação de conjunto OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Esse sinalizador só é válido quando essa estrutura é usada em solicitações de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED
Esse sinalizador especifica que o membro ProcessoryAffinity foi atualizado após a criação do VPort. A afinidade de processador de um VPort só poderá ser atualizada se o VPort estiver anexado ao PF no adaptador de rede. O membro ProcessoryAffinity pode ser atualizado usando uma solicitação de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Esse sinalizador só é válido quando essa estrutura é usada em solicitações de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED
Esse sinalizador especifica que o membro NumQueuePairs foi atualizado após a criação do VPort. Quando VMMQ (Virtual Machine Multiple Queues) está habilitado, o número de filas para Vports padrão e não padrão pode ser atualizado. O membro NumQueuePairs pode ser atualizado usando uma solicitação de conjunto OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
SwitchId
Um valor NDIS_NIC_SWITCH_ID que especifica o identificador do comutador no qual o VPort deve ser criado.
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.
Nota
A partir do 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.
VPortId
Um valor NDIS_NIC_SWITCH_VPORT_ID que especifica o identificador de um VPort no adaptador de rede. O valor é alocado pelo NDIS e é exclusivo no adaptador de rede.
O valor VPortId está dentro do intervalo de zero a (NumVPorts - 1), em que NumVPorts é o número de VPorts que o driver de miniporto configurou no adaptador de rede. O driver especifica esse número no numVPorts membro da estrutura NDIS_NIC_SWITCH_INFO. O driver retorna essa estrutura por meio de uma solicitação de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES.
Nota
Um identificador VPort de NDIS_DEFAULT_VPORT_ID é reservado para o VPort padrão anexado ao PF na opção NIC padrão.
VPortName
Um valor NDIS_VPORT_NAME que especifica o nome do VPort. Este membro contém uma descrição amigável do VPort.
AttachedFunctionId
Um valor NDIS_SRIOV_FUNCTION_ID que especifica a ID da Função Física (PF) ou da Função Virtual (VF) à qual o VPort está anexado. Um valor de NDIS_PF_FUNCTION_ID especifica que o VPort está anexado ao PF. Se o valor for um identificador VF válido, o VPort será anexado ao VF.
NumQueuePairs
Um valor ULONG que especifica o número de pares de fila configurados para este VPort.
Um par de filas consiste em uma fila de transmissão e fila de recebimento. Os pares de fila associados ao VPort padrão são configurados no momento da criação do comutador por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_SWITCH. Um ou mais pares de fila são configurados em um VPort não padrão por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.
InterruptModeration
Um valor NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION que especifica a configuração de moderação de interrupção do VPort.
VPortState
Um valor NDIS_NIC_SWITCH_VPORT_STATE que especifica o estado atual do VPort.
ProcessorAffinity
Um valor GROUP_AFFINITY que especifica o número do grupo e um bitmap das CPUs às quais esse VPort está associado. Esse campo é válido apenas para VPorts anexados ao PF.
Nota
Para VPorts PF não padrão, um valor GROUP_AFFINITY que especifica apenas um processador deve ser especificado quando o VPort é criado. VPorts são criados por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.
A afinidade do processador associada ao VPort não padrão anexado ao PF pode ser alterada após a criação do VPort. A afinidade do processador associada ao VPort padrão também pode ser alterada usando uma solicitação de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
LookaheadSize
Esse membro é reservado para uso futuro. Esse membro deve ser definido como zero.
NdkParams
QosSqId
Associa um vPort a uma Fila do Agendador (SQ). Defina esse campo como uma ID SQ válida para associar o vPort a um SQ. Defina esse campo como zero se não houver nenhuma associação SQ. Para obter mais informações sobre NDIS_QOS_SQ_ID, consulte OID_QOS_OFFLOAD_CREATE_SQ.
Observações
Essa estrutura é usada em solicitações OID de OID_NIC_SWITCH_CREATE_VPORT e OID_NIC_SWITCH_VPORT_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. |
| servidor com suporte mínimo | Windows Server 2022 |
| cabeçalho | ntddndis.h (inclua Ndis.h) |