estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS (ntddndis.h)
A estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS especifica a configuração de uma VPort (porta virtual) 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 miniporta deve definir o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT.
Para indicar a versão da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS , defina o membro Revision do Header como um dos seguintes valores:
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2
Adicionado o campo QosSqId para NDIS 6.50.
Defina o membro Size 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 Size 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 esse membro.
NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED
Esse sinalizador é reservado para uso futuro. Os drivers de miniporta 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 depois que o VPort tiver sido criado usando uma solicitação de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Observação
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.
Observação
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.
Observação
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.
Observação
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 OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Observação
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 o VMMQ (Máquina Virtual Várias Filas) 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 opções compatíveis com o adaptador de rede. Um valor NDIS_DEFAULT_SWITCH_ID indica o comutador de adaptador de rede padrão.
Observação
A partir do Windows Server 2012, a interface SR-IOV (virtualização de E/S raiz única) dá suporte apenas 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 membro NumVPorts 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.
Observação
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. Esse 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 VF (Função Virtual) à 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 filas 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 somente para VPorts anexados ao PF.
Observação
Para VPorts PF não padrão, um valor de GROUP_AFFINITY que especifica apenas um processador deve ser especificado quando o VPort é criado. As VPorts são criadas 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 OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
LookaheadSize
Este 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 associação SQ. Para obter mais informações sobre NDIS_QOS_SQ_ID, consulte OID_QOS_OFFLOAD_CREATE_SQ.
Comentários
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 SR-IOV (Virtualização de E/S de Raiz Única).
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.30 e posterior. |
| Servidor mínimo com suporte | Windows Server 2022 |
| Cabeçalho | ntddndis.h (inclua Ndis.h) |